FITSLIST

Lists the FITS extension of an NDF

Description:

This application lists the FITS  header stored in an NDF  FITS extension. The list may either be reported directly to you, or written to a text file. The displayed list of headers can be augmented, if required, by the inclusion of FITS headers representing the current World Co-ordinate System defined by the WCS component in the NDF (see Parameter ENCODING).

Usage:

fitslist in [logfile]

Parameters:

ENCODING = LITERAL (Read)
If a non-null value is supplied, the NDF WCS component is used to generate a set of FITS headers describing the WCS, and these headers are added into the displayed list of headers (any WCS headers inherited from the FITS extension are first removed). The value supplied for ENCODING controls the FITS keywords that will be used to represent the WCS. The value supplied should be one of the encodings listed in the “World Co-ordinate Systems” section below. An error is reported if the WCS cannot be represented using the supplied encoding. A trailing minus sign appended to the end of the encoding indicates that only the WCS headers should be displayed (that is, the contents of the FITS extension are not displayed if the encoding ends with a minus sign). Also see the FULLWCS parameter. [!]
FULLWCS = _LOGICAL (Read)
Only accessed if ENCODING is non-null. If TRUE then all co-ordinate frames in the WCS component are written out. Otherwise, only the current Frame is written out. [FALSE]
IN = NDF (Read)
The NDF whose FITS extension is to be listed.
LOGFILE = FILENAME (Read)
The name of the text file to store a list of the FITS extension. If it is null (!) the list of the FITS extension is reported directly to you. [!]

Examples:

fitslist saturn
The contents of the FITS extension in NDF saturn are reported to you.
fitslist saturn fullwcs encoding=fits-wcs
As above but it also lists the standard FITS world-co-ordinate headers derived from saturn’s WCS component, provided such information exists.
fitslist saturn fullwcs encoding=fits-wcs-
As the previous example except that it only lists the standard FITS world-co-ordinate headers derived from saturn’s WCS component. The headers in the FITS extension are not listed.
fitslist ngc205 logfile=ngcfits.lis
The contents of the FITS extension in NDF ngc205 are written to the text file ngcfits.lis.

Notes:

World Co-ordinate Systems

The ENCODING parameter can take any of the following values.

Related Applications

KAPPA: FITSEDIT, FITSHEAD; FIGARO: FITSKEYS.