The [x] part of the name is optional. If used [x] indicates the data type (one of R, D, I, L or C, the default is C) the item is to be returned in. So for instance if you want an item with type REAL, the subroutine that you should call is HDR_INR.
’FITS’ or ’’ for FITS headers). ’HISTORY’ and ’COMMENT’ items often have many occurrences). The number of
occurrences may be queried using the HDR_NUMB subroutine. This subroutine will directly access an image if an association has not already been made. Note that it will be opened for read-only access and you will not be able to write or delete any header items. If you need to be able to do this then access the image first, either with one of the ??x]]IMG_MOD[n][x] subroutines (if you intend to process the image data), or the HDR_MOD subroutine.
Item names from any source may be hierarchical (i.e. ING.DETHEAD gets the value of the FITS
header "ING DETHEAD"; BOUNDS.MAXX gets the value of the MAXX component of BOUNDS in a
non-FITS source).
This subroutine may be used to read the value of an item from the same source of more than one
image dataset at a time by using multiple parameter names. Multiple parameter names are provided
as a comma separated list (i.e. ’IN1,IN2,IN3’). The header source specified by XNAME must exist in
all images and the argument VALUE must be declared as a dimension of size at least the number of
parameters in the list; if this option is used.
If a header item is not found its associated element of the VALUE argument will remain unchanged. It is therefore important that suitable defaults are assigned to VALUE before calling this subroutine. The source must exist.