The routine creates a new array section, using an existing section as a template. The new section bears the same relationship to its base array as the template section does to its own base array. Allowance is made for pixel-index shifts which may have been applied so that the pixel-indices of the new section match those of the template. The number of dimensions of the input and template arrays may differ.

CALL ARY_SSECT( IARY1, IARY2, IARY3, STATUS )

IARY1 = INTEGER (Given)

IARY2 = INTEGER (Given)

IARY3 = INTEGER (Returned)

STATUS = INTEGER (Given and Returned)

• This routine normally generates an array section. However, if both input arrays are base arrays with identical pixel-index bounds, then there is no need to create a section in order to access the required part of the first array. In this case a base array identifier will be returned instead.

• The new section created by this routine will have the same number of dimensions as the array (or array section) from which it is derived. If the template (IARY2) array has fewer dimensions than this, then the bounds of any additional input dimensions are preserved unchanged in the new array. If the template (IARY2) array has more dimensions, then the excess ones are ignored.

• This routine takes account of the regions of each base array to which the input array sections have access. It may therefore restrict the region accessible to the new section (and pad with "bad" pixels) so as not to grant access to regions of the base array which were not previously accessible through the input arrays.

• If this routine is called with STATUS set, then a value of ARY__NOID will be returned for the IARY3 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.