CATCOORD

Convert to a new celestial coordinate system

Description:

Convert to a new celestial coordinate system.

The application will convert mean equatorial coordinates to mean equatorial coordinates for another equinox and epoch, to Galactic coordinates or to de Vaucoulerurs supergalactic coordinates. The new coordinates may be computed simply from an existing Right Ascension and Declination. Alternatively, more accurate values may be computed using columns of proper motion and parallax if these are available in the input catalogue.

A copy of the catalogue containing the new coordinates is created. The new coordinates may either replace coordinates in existing columns or be written to new columns.

Usage:

catcoord

Parameters:

CATIN = CHARACTER (read)
Name of the input catalogue.
CATOUT = CHARACTER (read)
Name of the output catalogue.
EPOCHI = CHARACTER (read)
The epoch of the input coordinates, eg: J2000 or B1950.
EQUINI = CHARACTER (read)
The equinox of the input coordinates, eg: J2000 or B1950.
RAIN = CHARACTER (read)
The name of the column containing Right Ascension in the input catalogue.
DECIN = CHARACTER (read)
The name of the column containing Declination in the input catalogue.
FULL = LOGICAL (read)
A flag indicating whether full input coordinates (including proper motions and parallax) are to be used or not. It is coded as follows: TRUE - use full input coordinates, FALSE _ simply use input Right Ascension and Declination.
PMRA = CHARACTER (read)
The name of the column containing the proper motion in Right Ascension in the input catalogue.
PMDE = CHARACTER (read)
The name of the column containing the proper motion in Declination in the input catalogue.
PLX = CHARACTER (read)
The name of the column containing the parallax in the input catalogue.
RV = CHARACTER (read)
The name of the column containing the radial velocity in the input catalogue.
COORDS = CHARACTER (read)
The type of output coordinates to be computed. The options are: EQUATORIAL - equatorial coordinates, GALACTIC - Galactic coordinates, SUPERGALACTIC - de Vaucoulerurs supergalactic coordinates.
EPOCHO = CHARACTER (read)
The epoch of the output coordinates, eg: J2000 or B1950.
EQUINO = CHARACTER (read)
The equinox of the output coordinates, eg: J2000 or B1950.
RAOUT = CHARACTER (read)
The name of the column to contain the Right Ascensions computed for the new equinox and epoch.
DECOUT = CHARACTER (read)
The name of the column to contain the Declinations computed for the new equinox and epoch.
L = CHARACTER (read)
The name of the column to contain the computed Galactic longitude.
B = CHARACTER (read)
The name of the column to contain the computed Galactic latitude.
SGL = CHARACTER (read)
The name of the column to contain the computed supergalactic longitude.
SGB = CHARACTER (read)
The name of the column to contain the computed supergalactic latitude.
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 catalogue, duplicated as comments, C - (default) copy only the comments from the input catalogue. In the case of a FITS table the COMMENTS and HISTORY keywords will be copied. 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:

catcoord
The input and output catalogues and various other details will be prompted for. A new catalogue containing the revised coordinates will be written. By default the new equatorial coordinates will be computed only from the Right Ascension and Declination in the input catalogue. Any comments in the input catalogue will be copied.
catcoord full=true
The input and output catalogues and various other details will be prompted for. A new catalogue containing the revised coordinates will be written. The new equatorial coordinates will be computed from the ’full’ coordinates in the input catalogue (that is, columns of proper motion and parallax will be used).
catcoord coords=galactic
The input and output catalogues and various other details will be prompted for. A new catalogue containing Galactic coordinates will be written. The Galactic coordinates will be computed only from the Right Ascension and Declination in the input catalogue.
catcoord full=true galactic=true
The input and output catalogues and various other details will be prompted for. A new catalogue containing Galactic coordinates will be written. The Galactic coordinates will be computed from the ’full’ coordinates in the input catalogue (that is, columns of proper motion and parallax will be used).
catcoord text=all
The input and output catalogues and various other details will be prompted for. A new catalogue containing the revised coordinates will be written. All the header information in the input catalogue will be duplicated as comments in the output catalogue.
catcoord text=none
The input and output catalogues and various other details will be prompted for. A new catalogue containing the revised coordinates will be written. Any comments in the input catalogue will not be copied.