Generate a new copy of a CAT
catalogue. By default all the columns, parameters and textual information in the input catalogue are
copied.
Optionally some or all of the parameters in the input catalogue can be omitted from the
output catalogue and new parameters can be added to the output catalogue. Also any
textual information associated with the input catalogue can be omitted from the output
catalogue.
It is possible to use catcopy to generate a copy of a catalogue in the same format (FITS table or
whatever) as the original, but there is little point in doing so; the same result can be achieved using the
Unix command ’cp’, which is much quicker. The real usefulness of catcopy is in converting a
catalogue to a new format, for example, converting a FITS table to an STL (small text list) format
catalogue.
CATIN = CHARACTER (read)
Name of the input
catalogue.
CATOUT = CHARACTER (read)
Name of the output catalogue.
COPYPAR =
CHARACTER (read)
Flag indicating which parameters are to be copied. The valid responses are: A -
all; (default) copy all the parameters, F - filter; omit (that is, filter out) selected parameters, N - none;
omit all the parameters.
PFILTER = CHARACTER (read)
A comma-separated list of the parameters
to filter out (that is, to omit).
ADDPAR = LOGICAL (read)
Flag indicating whether
any new parameters are to be added to the output catalogue. The permitted values are:
TRUE - add new parameters, FALSE - (default) do not add new parameters.
PNAME =
CHARACTER (read)
Name of the current new parameter.
PARTYP = CHARACTER
(read)
Data type of the current new parameter. The permitted types are: REAL, DOUBLE,
INTEGER, LOGICAL and CHAR.
PCSIZE = INTEGER (read)
Size of the current new
parameter if it is of type CHAR.
PVALUE = CHARACTER (read)
Value of the current
new parameter.
PUNITS = CHARACTER (read)
Units of the current new parameter.
PCOMM = CHARACTER (read)
Comments describing the current new parameter.
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.