
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:
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