KPG1_ASSMP

Returns co-ordinates at evenly spaces positions along a given poly-line

Description:

This routine returns an a pointer to an array holding the co-ordinates at a set of NSAMP positions evenly spaced along a poly-line defined by NPOS " profile positions" .

Invocation

CALL KPG1_ASSMP( FRAME, ARRDIM, NAX, NPOS, POS, GEO, NSAMP, SAMP, DELTA, STATUS )

Arguments

FRAME = INTEGER (Given)
An AST pointer to the Frame in which the polyline is defined. This is used to define geodesic curves joining the supplied profile positions. Only accessed if GEO is .TRUE.
ARRDIM = INTEGER (Given)
The size of the first dimension of POS.
NAX = INTEGER (Given)
The number of axes in the Frame.
NPOS = INTEGER (Given)
The number of profile positions defining the poly-line. This must be less than or equal to ARRDIM.
POS( ARRDIM, NAX ) = DOUBLE PRECISION (Given)
The profile positions. The first axis indexes the position number, and the first NPOS elements should be used. The second axis indexes the axis number. An error is reported if any invalid positions are supplied.
GEO = LOGICAL (Given)
Should the poly-line be constructed from geodesic curves in the supplied Frame? If not, the poly-line is made up of straight-line segments in the supplied Frame.
NSAMP = INTEGER (Given)
The number of samples required along the poly-line.
DELTA = DOUBLE PRECISION (Given and Returned)
The increment between samples. If not known, this should be set to zero. Returned holding the used increment.
SAMP( NSAMP, NAX ) = DOUBLE PRECISION (Returned)
The array holding the sample positions.
STATUS = INTEGER (Given)
Global status value.