next up previous 90
Next: Restoring catalogue access
Up: The Recipes
Previous: Displaying an Image


Retrieving Remote Images and Catalogues

When using remote facilities, such as those described in this recipe, you should ensure that you are both familiar with and comply with any obligations which they impose on you, such as correct acknowledgement of the use of data or services etc.

This recipe demonstrates how to retrieve an image of a specified region of sky from a remote archive and to overlay it with objects extracted from a remote catalogue. In both cases the data are retrieved via the Internet. As an example a region centered on the galaxy NGC 1275 will be used. Recall that the J2000 coordinates of this galaxy are:

$\alpha =$ $3^{\rm h}\,19^{\rm m}\,48\mbox{$^{\rm s}\!\!.$}16$,   $\delta =$ $+41^{\circ}\,30\raisebox{-0.5ex}{$^{'}$}\,42$ $^{'\hspace{-0.1em}'}$ . $1$

A region will be extracted from the on-line version of the DSS (Digitised Sky Survey) at ESO. The DSS is a photographic survey which covers the entire sky. It was constructed by the Space Telescope Science Institute (STScI) by digitising and combining surveys conducted with the Palomar and UK Schmidt telescopes (a UK mirror is available as part of the LEDAS data archive service at the Department of Physics and Astronomy, University of Leicester). The DSS image will then be overlaid with objects extracted from the USNO PMM astrometric catalogue[13].

The SuperCOSMOS image surveys also available from GAIA return images which have catalogues of objects detected in the images already attached and so combine the two stages into one operation. However, the SuperCOSMOS surveys currently only cover the sky south of Declination $+3^{\circ}$.

If the coordinates of your target region or object are not for epoch and equinox J2000 then you should convert them to this system. COCO (see SUN/56[18]) is available for this purpose. Though the target coordinates can be converted within GAIA it is probably better to convert them prior to starting it.

  1. Start GAIA. Type:

    % gaia &

    The ampersand (`&') is simply to run GAIA as a detached process, so that you can continue to issue Unix commands from the command line. After a few moments the main GAIA window should appear.

  2. The first step is to retrieve a two-dimensional image of the region of sky containing your target region or object. Click on the Data-Servers menu, located towards the right of the menu-bar at the top of the main window. Choose the Image Servers option and then Digitized Sky at ESO from amongst the list of servers (it will probably be the only choice). If the Digitized Sky at ESO is not amongst the choices offered then see Section [*], below.

    Figure: Window to retrieve a remote image of a region or object from the DSS
    \includegraphics[totalheight=3in]{sc17_retriev_r_dss.ps}

    A window similar to Figure [*] and titled Digitized Sky at ESO (1) should appear; it allows you to specify the region of sky to be retrieved.

    When the values are set, click on the Get Image button. After a few moments the retrieved image should be displayed in the main GAIA window. A small window entitled `FITS HDUs (1)' may also appear. Click on Close to close this window. Then click on Close to close the Digitized Sky at ESO (1) window.

  3. You may wish to save the retrieved image as a file for future use. Click on the File menu (the leftmost item in the menu-bar along the top of the main window) and choose the Save as... item. A window allowing you to save the image as a file will appear. The file will be written in FITS format. It is usual to end the file-name with a file-type of `.fits' or `.fit'.

  4. You may wish to adjust the appearance of the displayed image. The most likely items to change are Colors... and Magnification in the View menu (second from the left in the menu-bar along the top of the window).

    For example, click on the View menu and select the Colors... option. A panel will appear. Set:

    Then click on the Close button. Set the magnification by clicking on the Scale: button (in the bottom left of the control panel in the centre top of the window) and setting it to 2x.

    The display should now look something like Figure [*], which is a a reasonable approximation to the appearance of the original photographic plate.

    Figure: Retrieved Digitised Sky Survey (DSS) image centred on NGC 1275
    \includegraphics[totalheight=5in]{sc17_retriev_r_main.ps}

  5. Various remote catalogues are accessible from GAIA. The present recipe extracts objects from the USNO PMM astrometric catalogue[13] and overlays them on the image.

    First click on the Data-Servers menu, towards the right of the menu-bar at the top of the main window. Choose the Catalogs option and then USNO at ESO from amongst the list of catalogues (it will probably be towards the bottom of the list). If USNO at ESO is not amongst the choices offered then see Section [*], below.

    A window similar to Figure [*] and titled USNO at ESO (1) should appear; it allows you to retrieve objects from the catalogue. The central position and minimum and maximum radius should be already filled in (the values have been obtained from the two-dimensional image). The `Brightest (min):' and `Faintest (max):' boxes allow these quantities to be set, if desired. However, in the present example they can be left blank, and all the objects in the PMM which overlay the image will be selected.

    Figure: Window to retrieve objects from a remote version of the USNO PMM catalogue
    \includegraphics[totalheight=4in]{sc17_retriev_r_pmm.ps}

    Simply click on the Search button (in the bottom left of the window). After a couple of moments the selected objects are listed in the Search Results box and overlaid on the image in the main window.

    A useful feature for identifying objects in the list with the corresponding plotted symbol is that if you position the cursor over either a plot symbol or a row in the table and click with the left mouse button the corresponding row and plot symbol are highlighted.

    To save the selected objects as a text file click on the File menu in the USNO at ESO (1) window (the leftmost item in its menu-bar) and choose either Save as... or Print.... In both cases a window will appear which allows you to save the list. Note that though both options produce text files they are in different formats.

    If you choose the Save as... option the catalogue of objects will be saved as a file. The format in which this catalogue is saved depends on the file-type specified at the end of the file-name (see Section [*]). Catalogues saved in the FITS tables, TST or STL formats can subsequently be imported into CURSA (see SUN/190[5]) which provides additional catalogue manipulation facilities.

    When you have finished click the Close button to close the USNO at ESO (1) window.

  6. To close GAIA click on the File menu (the leftmost item in the menu-bar along the top of the main window) and choose the Exit option.



Subsections

next up previous 90
Next: Restoring catalogue access
Up: The Recipes
Previous: Displaying an Image

The GAIA Cookbook
Starlink Cookbook 17
A.C. Davenhall & P.W. Draper
31st December 2001
E-mail:starlink@jiscmail.ac.uk

Copyright © 2001 Council for the Central Laboratory of the Research Councils