CATPHOTOMTRN

Transform instrumental to calibrated mags. for programme stars

Description:

This application transforms instrumental magnitudes into calibrated magnitudes in some photometric system for a catalogue of programme objects. A new catalogue is written which contains the calibrated magnitudes as well as all the columns in the original catalogue.

The transformation coefficients used to convert the instrumental magnitudes are read from a file. Application catphotomfit can be used to prepare a suitable file. See the documentation for this application for details of the transformation used.

The transformation includes a term for the air mass through which the object was observed. By default a column containing the air mass is read from the input catalogue. However, optionally, a column containing the observed zenith distance of the object may be read instead and used to automatically calculate the air mass.

Usage:

catphotomtrn

Parameters:

ZENITHDIST = LOGICAL (read)
Flag; is the air mass read directly from a column or is it computed from the observed zenith distance? It is coded as follows: TRUE - computed from the observed zenith distance, FALSE - read directly from a column.
FILNME = CHARACTER (read)
The name of the file which contains the transformation coefficients.
INSCON = DOUBLE PRECISION (read)
Arbitrary constant previously added to the instrumental magnitudes.
CATIN = CHARACTER (read)
Name of the input catalogue.
CATOUT = CHARACTER (read)
Name of the output catalogue.
INSMAG = CHARACTER (read)
Name of the column or expression in the input catalogue holding the instrumental magnitudes.
AIRMASS = CHARACTER (read)
Name of the column or expression in the input catalogue holding the air mass.
ZENDST = CHARACTER (read)
Name of the column or expression in the input catalogue holding the observed zenith distance.
CALMAG = CHARACTER (read)
Name of the column in the output catalogue to hold the calibrated magnitudes.
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:

catphotomtrn
The input and output catalogues and various other details will be prompted for. A new catalogue containing the calibrated magnitudes will be written. All the header information in the input catalogue will be duplicated as comments in the output catalogue.
catphotomtrn zenithdist=true
The input and output catalogues and various other details will be prompted for. You should supply a column containing the observed zenith distance rather than one containing the air mass. This column will be used to calculate the air mass automatically.
catphotomtrn text=all
The input and output catalogues and various other details will be prompted for. A new catalogue containing the calibrated magnitudes will be written. All the header information in the input catalogue will be duplicated as comments in the output catalogue.
catphotomtrn text=none
The input and output catalogues and various other details will be prompted for. A new catalogue containing the calibrated magnitudes will be written. Any comments in the input catalogue will not be copied.