next up previous
Next: NDF_SIZE - Determine the size of an NDF
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_SECT - Create an NDF section

NDF_SHIFT - Apply pixel-index shifts to an NDF   

Description:
The routine applies pixel-index shifts to an NDF. An integer shift is applied to each dimension so that its pixel-index bounds, and the indices of each pixel, change by the amount of shift applied to the corresponding dimension. The NDF's pixels retain their values and none are lost.

Invocation:
CALL NDF_SHIFT( NSHIFT, SHIFT, INDF, STATUS )

Arguments:
NSHIFT = INTEGER (Given)
Number of dimensions to which shifts are to be applied. This must not exceed the number of NDF dimensions. If fewer shifts are applied than there are NDF dimensions, then the extra dimensions will not be shifted.
SHIFT( NSHIFT ) = INTEGER (Given)
The pixel-index shifts to be applied to each dimension.
INDF = INTEGER (Given)
NDF identifier.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • Pixel-index shifts applied to a base NDF will affect the appearance of that NDF as seen by all base-NDF identifiers associated with it. However, NDF sections derived from that base NDF will remain unchanged (as regards both pixel-indices and array values).
  • Pixel-index shifts applied to an NDF section only affect that section itself, and have no effect on other NDF identifiers.
  • Pixel-index shifts cannot be applied to a base NDF while any of its components (or any of its axis arrays) is mapped for access, even through another identifier.
  • Pixel-index shifts cannot be applied to an NDF section while any of its components (or any of its axis arrays) is mapped for access through the identifier supplied to this routine.



next up previous
Next: NDF_SIZE - Determine the size of an NDF
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_SECT - Create an NDF section


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