Processing math: 100%

IRQ_SETQL8

Assign a given quality to a list of pixels, leaving unlisted pixels unchanged

Description:

This routine is equivalent to IRQ_SETQL except that variables LIST, NCOORD and SET are stored in INTEGER8 values rather than INTEGER.

The quality specified by QNAME is assigned to all pixels included (or, if LISTED is false, not included) in the supplied list of pixel indices. The quality of other pixels is left unaltered. The quality name must be defined in the NDF specified by LOCS (LOCS should be obtained either by calling IRQ_FIND or IRQ_NEW). An error is reported if the quality name is undefined.

Note, write or update access must be available for the NDF (as set up by routine LPG_ASSOC for instance), and the QUALITY component must not be mapped on entry to this routine.

Invocation

CALL IRQ_SETQL8( LOCS, LISTED, QNAME, NDIM, NCOORD, LIST, SET, 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.
LISTED = LOGICAL (Given)
If true, then the quality is assigned to all pixels included in the list given by LIST. If false, then the quality is assigned to all pixels not included in the list given by LIST.
QNAME = CHARACTER ( ) (Given)
The quality name to assign to the selected pixels. This quality name must be defined in the NDF specified by LOC. Name definitions can be added to the NDF using routine IRQ_ADDQN.
NDIM = INTEGER (Given)
The number of values required to specify a pixel position (i.e. the number of dimensions in the NDF).
NCOORD = INTEGER8 (Given)
The number of pixels included in the input list.
LIST( NDIM, NCOORD ) = INTEGER8 (Given)
The list of pixel indices. Any indices which lie outside the bounds of the NDF are ignored.
SET = INTEGER8 (Returned)
The number of pixels in the NDF which hold the quality.
STATUS = INTEGER (Given and Returned)
The global status.