next up previous
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 up previous
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