Create a copy
of a catalogue sorted on a specified column. Note that catsort generates a new sorted catalogue; it
does not overwrite the original catalogue. The new catalogue can be sorted into either
ascending or descending order. All the columns and parameters in the input catalogue are
copied. Optionally any textual information associated with the input catalogue can also be
copied.
Catalogues can be sorted on columns of any of the numeric data types. They should not be sorted on
columns of data type CHARACTER or LOGICAL. If a catalogue is sorted on a column which contains
null values then the rows for which the column is null will appear after all the rows with a valid value.
The order of such rows is unpredictable.
CATIN = CHARACTER
(read)
Name of the input catalogue.
CATOUT = CHARACTER (read)
Name of the
output catalogue, sorted on the specified column.
FNAME = CHARACTER (read)
The
name of the column the output catalogue is to be sorted on.
ORDER = CHARACTER
(read)
Order into which the catalogue is to be sorted: ascending or descending.
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.
Catalogues should not be sorted on columns of data type CHARACTER or LOGICAL.