Next: HDR_NUMB- Return a header item count
Up: HDR Fortran subroutines
Previous: HDR_MOD- Open an image allowing modification of any header items
HDR_NAME- Return a header item name
- Description:
- This subroutine returns the name of a header item using an index
of its relative position within a named source. By incrementing
index N all the names in a source may be queried.
- Invocation:
- CALL HDR_NAME( PARAM, XNAME, N, ITEM, STATUS )
- Arguments:
-
-
PARAM = CHARACTER * ( * ) (Given)
-
Parameter name of the image (case insensitive).
-
XNAME = CHARACTER * ( * ) (Given)
-
Source of the header information
('FITS' or ' ' for FITS headers).
-
N = INTEGER (Given)
-
The index of the item.
-
ITEM = CHARACTER * ( * ) (Returned)
-
The name of the header item (blank when no item with the
given index exists).
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
- 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
IMG_MOD[n][x] subroutines
(if you intend to process the image data), or the
HDR_MOD subroutine.
- The order in which header item names are returned may change if
the source is modified (by deletion or by writing).
- The header item name will be returned in a hierarchical format
if necessary.
- The total number of items from a source can be found using
HDR_NUMB.
Next: HDR_NUMB- Return a header item count
Up: HDR Fortran subroutines
Previous: HDR_MOD- Open an image allowing modification of any header items
IMG Simple Image Data Access
Starlink User Note 160
P.W. Draper
R.F. Warren-Smith
3 March 2003
E-mail:P.W.Draper@durham.ac.uk
Copyright © 2000-2003 Council for the Central Laboratory of the Research Councils