Remote Interfaces

SkyCat::get_catalog

This proc returns the instance name of a catalog widget. If more than one catalog window is open, it asks the user to select one from a list. If it can't find one, it reports an error and returns an empty string.

SkyCat::get_imagesvr

Same as above, but for the image server (DSS) window.

SkyCat::get_catalog_info

Returns the contents of the catalog window as a Tcl list. The format of the return value is {{ selected_row } {{ row1 } { row2 } ...}} where each row is a list of column values. The selected_row is empty if there is no selection, otherwise it is a list of column values in the selected row.

SkyCat::display_image

Fetch and display an image (from DSS), given the world coordinates (ra, dec, equinox) and a width and height in arcmin.

SkyCat::mark_image

Display a rectangle on the image at the given world coordinates center coordinates with the given width and height in arcmin and return the item's canvas tag or id.

SkyCat::unmark_image

Remove the given mark from the image, by specifying the id returned from SkyCat::mark_image.

SkyCat::load_image

Load a FITS image for viewing.

SkyCat::pick_object

Pop up a window and ask the user to select an object in the image. Wait for the selection and return the information for it in the form:

{x y ra dec equinox fwhmX fwhmY angle object background}

An optional Tcl command may be specifed to be called whenever a new object is selected. The command can include a " send ..." prefix to call a proc in another application.

SkyCat::get_skycat_images

Return a list of SkyCatCtrl class instances in this process (there might be multiple cloned instances of the image window, created via the " New Window" menu item). To get the top level window for an image, you can use the command [winfo toplevel $skycatImage]. The main windows for skycat have names such as .skycat1, .skycat2, etc., although you should not use the hard coded names. Use SkyCat::get_skycat_images and check that the return value actually still exists with [winfo exists $skycatImage].