SAMP Control

SAMP plugin

The SAMP plugin implements a SAMP interface for the Ginga reference viewer.


To run this plugin, you need to install astropy that has the samp module.

Plugin Type: Global

SAMP is a global plugin. Only one instance can be opened.


Ginga includes a plugin for enabling SAMP (Simple Applications Messaging Protocol) support. With SAMP support, Ginga can be controlled and interoperate with other astronomical desktop applications.

The SAMP module is not started by default. To start it when Ginga starts, specify the command line option:


Otherwise, start it using “Start SAMP” from the “Plugins” menu.

Currently, SAMP support is limited to image.load.fits messages, meaning that Ginga will load a FITS file if it receives one of these messages.

Ginga’s SAMP plugin uses the astropy.samp module, so you will need to have astropy installed to use the plugin. By default, Ginga’s SAMP plugin will attempt to start a SAMP hub if one is not found running.

It is customizable using ~/.ginga/plugin_SAMP.cfg, where ~ is your HOME directory:

# SAMP plugin preferences file
# Place this in file under ~/.ginga with the name "plugin_SAMP.cfg"

SAMP_channel = 'Image'

# Default location is set by Ginga's viewer.
#cache_location = '/my/cache/path/'

default_connect = True

start_hub = True