KPG1_HSECT

Copy a section from an HDS array to a new component

Description:

This routine creates a new HDS object holding a copy of a section of a supplied primitive HDS array. The section may extend outside the bounds of the supplied array, in which case the new areas will be filled with bad values (or spaces if the array holds character data).

Invocation

CALL KPG1_HSECT( LOC1, NDIM, LBND, UBND, LOC2, NAME, STATUS )

Arguments

LOC1 = CHARACTER∗(DAT__SZLOC) (Given)
An HDS locator for a primitive array object. This array has implicit lower bounds of (1,1,1,...) and upper bounds equal to its dimension sizes.
NDIM = INTEGER (Given)
The dimensionality of the required section. An error will be reported if this is not the same as the dimensionality of the supplied HDS array.
LBND( NDIM ) = INTEGER (Given)
The lower bounds of the required array section.
UBND( NDIM ) = INTEGER (Given)
The upper bounds of the required array section.
LOC2 = CHARACTER∗(DAT__SZLOC) (Given)
An HDS locator for a structure in which to create the new component holding a copy of the required array section.
NAME = CHARACTER∗(DAT__SZNAM) (Given)
The name of the new component to create within the " LOC2" structure. Any existing component with this name will be erased first.
STATUS = INTEGER (Given and Returned)
The global status.