next up previous
Next: NDF_MBND - Match the pixel-index bounds of a pair of NDFs
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_MBAD - Merge the bad-pixel flags of the array components of a pair of NDFs

   
NDF_MBADN - Merge the bad-pixel flags of the array components of a number of NDFs

Description:
The routine merges the bad-pixel flag values of an array component (or components) for a number of NDFs, returning the logical "OR" of the separate values for each NDF. In addition, if bad pixels are found to be present in any NDF but the application indicates that it cannot correctly handle such values, then an error to this effect is reported and a STATUS value is set.

Invocation:
CALL NDF_MBADN( BADOK, N, NDFS, COMP, CHECK, BAD, STATUS )

Arguments:
BADOK = LOGICAL (Given)
Whether the application can correctly handle NDF array components containing bad pixel values.
N = INTEGER (Given)
Number of NDFs whose bad-pixel flags are to be merged.
NDFS( N ) = INTEGER (Given)
Array of identifiers for the NDFs to be merged.
COMP = CHARACTER * ( * ) (Given)
Name of the NDF array component: 'DATA', 'QUALITY' or 'VARIANCE'.
CHECK = LOGICAL (Given)
Whether to perform explicit checks to see whether bad pixels are actually present. (This argument performs the same function as in the routine NDF_BAD.)
BAD = LOGICAL (Returned)
The combined bad-pixel flag value (the logical "OR" of the values obtained for each NDF).
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • A comma-separated list of component names may also be supplied, in which case the routine will take the logical "OR" of all the specified components when calculating the combined bad-pixel flag value.
  • The effective value of the bad-pixel flag for each NDF array component which this routine uses is the same as would be returned by a call to the routine NDF_BAD.
  • If this routine detects the presence of bad pixels which the application cannot support (as indicated by a .FALSE. value for the BADOK argument), then an error will be reported to this effect and a STATUS value of NDF__BADNS (bad pixels not supported) will be returned. The value of the BAD argument will be set to .TRUE. under these circumstances. The NDF__BADNS constant is defined in the include file NDF_ERR.



next up previous
Next: NDF_MBND - Match the pixel-index bounds of a pair of NDFs
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_MBAD - Merge the bad-pixel flags of the array components of a pair of NDFs


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