Catalogs¶
A plugin for plotting object locations from a catalog on an image.
Plugin Type: Local
Catalogs
is a local plugin, which means it is associated with a
channel. An instance can be opened for each channel.
Usage
Before Catalogs
can be used, you need to define at least one catalog or
image server to be queried in ginga_config.py
. Here is an example for
defining three cone search catalogs for guide stars:
def pre_gui_config(ginga):
from ginga.util.catalog import AstroPyCatalogServer
# Add Cone Search services
catalogs = [
('The HST Guide Star Catalog, Version 1.2 (Lasker+ 1996) 1',
'GSC_1.2'),
('The PMM USNO-A1.0 Catalogue (Monet 1997) 1', 'USNO_A1'),
('The USNO-A2.0 Catalogue (Monet+ 1998) 1', 'USNO_A2'),
]
bank = ginga.get_ServerBank()
for longname, shortname in catalogs:
obj = AstroPyCatalogServer(
ginga.logger, longname, shortname, '', shortname)
bank.addCatalogServer(obj)
def post_gui_config(ginga):
pass
Then, start Ginga and then start the Catalogs
local plugin from the
channel you want to perform searchs on. You will see the catalogs listed
in a drop-down menu on the plugin GUI.
Draw a shape on the displayed image and adjust search parameters as desired. When you are ready, press on the button to perform the search. When search results are available, they will be displayed on the image and also listed in a table on the plugin GUI. You can click on either the table or the image to highlight selection.
It is customizable using ~/.ginga/plugin_Catalogs.cfg
, where ~
is your HOME directory:
#
# Catalogs plugin preferences file
#
# Place this in file under ~/.ginga with the name "plugin_Catalogs.cfg"
draw_type = 'circle'
select_color = 'skyblue'
color_outline = 'aquamarine'
click_radius = 10