FTS1_MANDH

Obtains the values of the mandatory headers in a FITS file

Description:

This routine searches for the mandatory FITS header keywords stored in a buffer, and their values are returned, if they are present. Should an item be missing or have an unsupported value an error is reported, a bad status is set and the routine exits. This version supports mandatory descriptors that are not in the correct order.

Currently, only simple FITS and group-format FITS are supported.

The number of dimensions is reduced when the highest dimension is one.

Invocation

CALL FTS1_MANDH( FIRST, NCARD, HEADER, SCARD, BITPIX, NDIM, AXIS, DARRAY, NONSDA, SIZE, STATUS )

Arguments

FIRST = LOGICAL (Given)
If true the buffer contains the first header of a FITS file. It is used to validate the header.
NCARD = INTEGER (Given)
The number of card images in the header.
HEADER( NCARD ) = CHARACTER ∗ 80 (Given)
The array of headers (80-character cards) to be searched for the mandatory keywords.
SCARD = INTEGER (Given)
The number of the card from where the searches of the header will begin. This is needed because the headers make contain a dummy header prior to an extension.
BITPIX = INTEGER (Returned)
The number of bits per pixel of the data array.
NDIM = INTEGER (Returned)
The number of active dimensions.
AXIS( DAT__MXDIM ) = INTEGER (Returned)
The dimensions of the data array.
DARRAY = LOGICAL (Returned)
If true there is a data array.
NONSDA = LOGICAL (Returned)
If true the data array is non-standard.
SIZE = INTEGER (Returned)
The number of pixels in the (or each) data array.
STATUS = INTEGER (Given and Returned)
Global status value.