NDF_SQMF - Set a new logical value for an NDF's quality masking flag

Description:

The routine sets a new logical value for an NDF's quality masking flag. This flag determines whether the NDF's quality component (if present) will be used to generate "bad" pixel values for automatic insertion into the data and variance arrays when these are accessed in READ or UPDATE mode. If this flag is set to .TRUE., then masking will occur, so that an application need not consider the quality information explicitly. If the flag is set to .FALSE., then automatic masking will not occur, so that the application can process the quality component by accessing it directly.

Invocation:

CALL NDF_SQMF( QMF, INDF, STATUS )

Arguments:

QMF = LOGICAL (Given)

The logical value to be set for the quality masking flag.

INDF = INTEGER (Given)

NDF identifier.

STATUS = INTEGER (Given and Returned)

The global status.

Notes:

• A quality masking flag is associated with each NDF identifier and is initially set to .TRUE.. Its value changes to .FALSE. whenever the quality component is accessed directly (e.g. using NDF_MAP or NDF_MAPQL) and reverts to .TRUE. when access is relinquished (e.g. using NDF_UNMAP). This default behaviour may also be over-ridden by calling NDF_SQMF to set its value explicitly. The routine NDF_QMF allows the current value to be determined.

• The value of the quality masking flag is not propagated to new identifiers.