CATGSCIN - Convert a GSC region to the preferred CURSA format

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.