Next: NDF_SSARY - Create an array section, using an NDF section as a template
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_SIZE - Determine the size of an NDF
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.
Next: NDF_SSARY - Create an array section, using an NDF section as a template
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_SIZE - Determine the size of an NDF
Starlink User Note 33
R.F. Warren-Smith
11th January 2000
E-mail:rfws@star.rl.ac.uk
Copyright © 2000 Council for the Central Laboratory of the Research Councils