KPG1_AXCOx

Obtains for an axis the axis indices given their values

Description:

This routine determines floating-point axis indices within an axis array for a series of pixel co-ordinates. It assumes that the array is monotonic and approximately linear, since it uses linear interpolation to derive the pixel indices. This routine may be used for arbitrary 1-d arrays in addition to axes, provided this criterion is met.

Invocation

CALL KPG1_AXCOx( LBND, UBND, AXIS, EL, VALUE, INDEX, STATUS )

Arguments

LBND = INTEGER (Given)
The lower bound of the axis array.
UBND = INTEGER (Given)
The upper bound of the axis array.
AXIS( LBND:UBND ) = ? (Given)
The axis array.
EL = INTEGER (Given)
The number of indices whose values in the axis array are to be found.
VALUE( EL ) = ? (Given)
The axis-array values.
INDEX( EL ) = ? (Returned)
The pixel co-ordinates of the values in the axis array. Notice that this is in floating point as fractional positions may be returned. An index is set to the bad value when its input co-ordinate lies outside the range of co-ordinates in the axis.
STATUS = INTEGER (Given and Returned)
The global status.

Notes: