To generate a new copy of a catalogue type:
The amount of textual information written to the output catalogue is controlled using the command line mechanism described in Section 10.1. You then answer the two prompts described below. In these descriptions the prompts are identified by the corresponding ADAM parameter name, which appears at the start of the prompt line.
CATIN
CATOUT
It is possible to use catcopy
to generate a copy of a catalogue in the same format (FITS table, TST or
STL) 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; that is, for example, converting a FITS table to an STL catalogue or vice
versa.
catcopy
has options to omit some or all of the parameters in the input catalogue from the output
catalogue or to add new parameters to the output catalogue. To omit all the parameters from the
output catalogue type:
To omit (or ‘filter out’) selected parameters type:
After being prompted for the input and output catalogues, CATIN
and CATOUT
, as above, you will be
prompted for the following parameter:
PFILTER
Alternatively, this parameter can be given on the command line, for example:
Note that here the list of parameters must be enclosed in quotes, and each quote must be preceded by a backslash character, as shown, to prevent the quote being interpreted by the Unix shell. To add new parameters to the output catalogue type:
An arbitrary number of new parameters can be added. After being prompted for the input and output
catalogues, CATIN
and CATOUT
, you will be prompted to supply the following details for each
parameter.
PNAME
PARTYP
REAL
, DOUBLE
, INTEGER
, LOGICAL
and CHAR
.
PCSIZE
CHAR
.
PVALUE
PUNITS
PCOMM