KPG1_BBOXx

Determines the bounding box of selected pixels in an n-dimensional array

Description:

This routine compresses an n-dimensional array by integer factors along each dimension by summing the array values in a rectangular box. The output may be normalised to take account of any bad values that may be present.

Invocation

CALL KPG1_BBOXx( NDIM, LBND, UBND, ARRAY, VALUE, EQUAL, BLBND, BUBND, NPASS, STATUS )

Arguments

NDIM = INTEGER (Given)
The dimensionality of the n-dimensional array.
LBND( NDIM ) = INTEGER (Given)
The lower pixel index bounds of the input n-dimensional array.
UBND( NDIM ) = INTEGER (Given)
The upper pixel index bounds of the input n-dimensional array.
ARRAY( ∗ ) = ? (Given)
The input n-dimensional data array.
VALUE = ? (Given)
The data value used to define the box. VAL__BADx is a legal value for this argument.
EQUAL = LOGICAL (Given)
If .TRUE., then the returned box encloses all pixels with value equal to VALUE. If .FALSE., then the returned box encloses all pixels with value not equal to VALUE.
BLBND( NDIM ) = INTEGER (Returned)
The lower pixel index bounds of the required box.
BUBND( NDIM ) = INTEGER (Returned)
The upper pixel index bounds of the required box.
NPASS = INTEGER (Returned)
The number of array elements that pass the test specified by VALUE and EQUAL. In general, the number of elements in the returned bounding box will be greater than NPASS.
STATUS = INTEGER (Given and Returned).
Global status value

Notes:

Bugs:

{note_bugs_here}