next up previous
Next: ARY_SHIFT - Apply pixel-index shifts to an array
Up: Routine Descriptions
Previous: ARY_SBND - Set new pixel-index bounds for an array

ARY_SECT  -  Create an array section

Description:
The routine creates a new array section which refers to a selected region of an existing array (or array section). The section may be larger or smaller in extent than the original array.

Invocation:
CALL ARY_SECT( IARY1, NDIM, LBND, UBND, IARY2, STATUS )

Arguments:
IARY = INTEGER (Given)
Identifier for the initial array.
NDIM = INTEGER (Given)
Number of dimensions for new section.
LBND( NDIM ) = INTEGER (Given)
Lower pixel-index bounds for the new section.
UBND( NDIM ) = INTEGER (Given)
Upper pixel-index bounds for the new section.
IARY2 = INTEGER (Returned)
Identifier for the new section.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • The number of section dimensions need not match the number of dimensions in the initial array. Pixel-index bounds will be padded with 1 's as necessary to identify the pixels to which the new section should refer.

  • Note that sections which extend beyond the pixel-index bounds of the initial array will be padded with bad pixels.

  • If this routine is called with STATUS set, then a value of ARY__NOID will be returned for the IARY2 argument, although no further processing will occur. The same value will also be returned if the routine should fail for any reason. The ARY__NOID constant is defined in the include file ARY_PAR.



next up previous
Next: ARY_SHIFT - Apply pixel-index shifts to an array
Up: Routine Descriptions
Previous: ARY_SBND - Set new pixel-index bounds for an array



ARY A Subroutine Library for Accessing ARRAY Data Structures
Starlink User Note 11
R.F. Warren-Smith
28th April 1998
E-mail:rfws@star.rl.ac.uk