Description:
This routine searches for a
specified quality name in the quality name specified by LOCS, and returns information
related to the quality name. If the quality name is not defined then an error is reported
and STATUS returned equal to IRQ__NOQNM.
Invocation
CALL IRQ_GETQN( LOCS,
QNAME, FIXED, VALUE, BIT, COMMNT, STATUS )
Arguments
LOCS(5) = CHARACTER
(
) (Given)
An array of five HDS locators. These locators identify the NDF and the associated quality name information.
They should have been obtained using routine IRQ_FIND or routine IRQ_NEW.
QNAME = CHARACTER
(
)
(Given)
The quality name to search for. Leading blanks are ignored and the search is case-insensitive.
The maximum allowed length for quality names is given by symbolic constant IRQ__SZQNM which
currently has the value of 15.
FIXED = LOGICAL (Returned)
If true, then the quality is either held
by all pixels, or by no pixels. In this case the quality may not have a corresponding bit in the
QUALITY component. If false, then some pixels have the quality and some do not, as indicated by the
corresponding bit in the QUALITY component.
VALUE = LOGICAL (Returned)
If FIXED is true,
then VALUE specifies whether all pixels hold the quality (VALUE = .TRUE.), or whether no pixels
hold the quality (VALUE = .FALSE.). If FIXED is false, then VALUE is indeterminate.
BIT = INTEGER (Returned)
BIT holds the corresponding bit number in the QUALITY
component. The least-significant bit is called Bit 1 (not Bit 0). If there is no corresponding bit, a
value of zero is returned, and FIXED is returned .TRUE.
COMMNT = CHARACTER
(
)
(Returned)
The descriptive comment which was stored with the quality name. The supplied
character variable should have a declared length given by symbolic constant IRQ__SZCOM.
STATUS = INTEGER (Given and Returned)
The global status.
Copyright © 2009 Science and Technology Facilities Council.