This class extends the AstroCat catalog widget browser class (see AstroCat(n) to add support for plotting objects and displaying images.
results SkyQueryResult(n) widget to display the results of a catalog query. searchopts SkyQuery(n) widget (derived from AstroQuery(n)) for displaying search options.
-canvasfont Font used in canvas to mark objects. -id Optional unique id, used in searching for already existing catalog widgets.
clear {} Clear the table listing (done in base class) and remove any plot symbols from the display. convert_coords {in_x in_y in_units out_units} Convert the given input coordinates in the given input units to the given output units and return a list {x y} with the new values. The units may be one of {canvas image wcs deg "wcs $equinox", "deg $equinox"}. delete_objects {} Delete any graphic objects in the image belonging to this catalog. deselect_objects {} Deselect any objects in the image. deselect_symbol {tag} Deselect the given symbol, given its canvas tag or id. display_image_file {filename} Display the given image file. filter_query_results {} Remove any items in the query result list that have not been plotted because they were not in the image (circular search/rectangualr image). gen_blank_image {} Generate a dummy blank image for the purpose of plotting catalog objects on it. Return 0 if OK, otherwise 1. gen_pix_image {radius} Generate a blank image without WCS. radius is radius of the image in pixels, Returns "0" if all is OK. gen_wcs_image {ra_deg dec_deg equinox radius} Generate a blank image that supports world coordinates for the purpose of plotting catalog objects. ra_deg, dec_deg and equinox give the center of the image (in deg), radius the radius in arcmin. Returns "0" if all is OK. get_display_height {} Retun the height of the image display canvas. get_display_width {} Retun the width of the image display canvas. get_image_name {} Return the name (file or object name) of the currently loaded image, or empty if no image is loaded. get_table_row {id} Return the table row index corresponding the given symbol canvas id. Note: The plot subcommand in SkySearch.C adds a canvas tag "row#$rownum" that we can use here. Also: cat$id is first tag in the tag list for each object. label_object_in_image {id name} Insert the id for the given object in the image near the object and return a string containing status info. name identifies the source catalog (short_name). make_label {name id x y units text color} Add a label to the image at the given coordinates (in the given units) with the given text and color. The id arg should be a unique id for the label in the catalog and $name should be the short name of the catalog. $units may be any of the units supported by the RTD {image canvas screen "wcs $equinox" "deg $equinox"}. picked_wcs_object {x y units} This method is called when the user clicks on a graphic symbol for a star. The user might be selecting this star, so call the RtdImage method to do that. plot {} Plot the stars/objects found in the previous search in the image window. The symbols to use are taken from the config file. plot_again {} Re-plot the listed objects. save_with_image {} Save the current data as a FITS table in the current image file. select_region {x0 y0 x1 y1} This method is called when a region of the image has been selected (From class SkyCat, via -regioncommand option when creating the image). The arguments are the bounding box of the region in canvas coords. Select any catalog symbols in the region. select_symbol {id toggle {rownum -1}} Select a symbol, given the canvas id and optional row number in the table listing. If $toggle is 0, deselect all other symbols first, otherwise toggle the selection of the items given by $id. set_state {state} Set/reset widget states while busy (redefined from parent class AstroCat).
add_dialog_buttons {} Add the dialog button frame (redefined from parent class AstroCat to add Plot button). add_result_table {} Add the table for displaying the query results (redefined from parent class AstroCat to add image support). add_search_options {} Add the search options panel (redefined from parent class AstroCat to add image support). init {} Called after options have been evaluated. label_selected_object {} Insert the Id for the object selected in the Table in the image near the object. make_short_help {} Add a short help window and set the help texts (redefined from parent class AstroCat). select_result_row {} Called when a row in the table is selected. Redefined from parent clas to also select the plot symbol.
canvas_ Canvas window containing main image. draw_ CanvasDraw object for drawing on image. image_ Internal rtdimage image for main image. label_tag_ Canvas tag used to identify all labels for this instance. object_tag_ Canvas tag used to identify all objects for this instance. skycat_ SkyCatCtrl widget instance. symbols_ Array containing supported symbol names. tag_ Canvas tag used to identify all symbols for this instance. wcs_ Name of wcs object for converting between hh:mm:ss and double deg.
history_catalog_ Name of the history catalog. history_cols_ List of columns in the history catalog.
Please send questions or comments to abrighto@eso.org.
Copyright © 1998 ESO - European Southern Observatory