- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑
arySect
Create an array section
Description:
This function 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
void arySect( Ary
ary1, int ndim, const
hdsdim lbnd, const
hdsdim ubnd, Ary
ary2,
int 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 NULL will be returned for the "
ary2"
argument, although no further processing will occur. The same value will also be returned if the
routine should fail for any reason.
Parameters :
ary
Identifier for the initial array.
ndim
Number of dimensions for new section. This is the length of the "
lbnd"
and Ubnd"
arrays.
lbnd
Lower pixel-index bounds for the new section.
ubnd
Upper pixel-index bounds for the new section.
ary2
Address of a variable in which to return an identifier for the new section.
status
The global
status.
- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑