Description:
Convert a FITS table containing a region of the HST Guide Star Catalogue (GSC) into a
FITS table with the preferred CURSA format. This format has the Right Ascension and
Declination formatted as CURSA angular columns and is sorted on Declination. Though CURSA
can access the GSC regions directly it is more convenient to process them with catgscin
first.
The name of the output FITS table is generated automatically from the name of the input GSC region.
GSC regions have names of the form region-number.gsc (where region-number is an integer number).
The name of the output catalogue is ’gsc’ followed by the region number. Thus, for example, if region
5828.gsc was imported the converted catalogue would be written to FITS table gsc5828.FIT.
Usage:
catgscin
Parameters:
CATIN = CHARACTER (read)
Name of the input GSC
region.
TEXT = CHARACTER (read)
Flag indicating the textual header information to
be copied. The valid responses are: A - all; the output catalogue will contain a complete
copy of the header information for the input GSC region, duplicated as comments, C -
(default) copy only the comments from the input GSC region. N - none; no textual header
information is copied.
QUIET = LOGICAL (read)
Operate in quiet mode where warnings are
suppressed. The permitted values are: TRUE - quiet mode, FALSE - verbose mode.
Examples:
catgscin
The input GSC region will be prompted for and then conversion proceeds.
Comments in the input region will be copied. catgscin text=all
The input GSC region
will be prompted for and then conversion proceeds. All the header information in the
input region will be duplicated as comments in the output catalogue. catgscin text=none
The input GSC region will be prompted for and then conversion proceeds. Comments in
the input catalogue will not be copied. catgscin input-region
Here the input region
has been specified on the command line. Because no value was specified for parameter
TEXT the default will be adopted and comments in the region catalogue will be copied.
Copyright © 2001 Council for the Central Laboratory of the Research Councils