- ←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 ↑