KPG1_ASGRP

Reads spatial positions from a GRP group

Description:

This routine reads formatted positions from a GRP group. The positions are assumed to be in the supplied Frame. Each element in the group should contain 1 position per line. Each position is given by a set of strings delimited by comma, space or tab (the first gives the value for Axis 1, the second for Axis 2, etc.). The number of strings per element in the group should equal the number of axes in the Base Frame of the supplied FrameSet.

An error is reported if any unreadable elements are found.

Invocation

CALL KPG1_ASGRP( PARAM, FRM, IGRP, NP, NAX, OUT, STATUS )

Arguments

PARAM = CHARACTER ∗ ( ∗ ) (Given)
The name of an environment parameter to use to get the indices of the columns within the text file which are to be used. If blank, the file must contain exactly NAX columns, all of which are used. If a null value is supplied, the dynamic default values will be used, which is [1,2,3... NAX].
FRM = INTEGER (Given)
A pointer to an AST Frame.
IGRP = INTEGER (Given)
A GRP identifier for the group to read.
NP = INTEGER (Given)
The number of positions which can be stored in the returned array.
NAX = INTEGER (Given)
The number of axes in the supplied Frame.
OUT( NP, NAX ) = DOUBLE PRECISION (Returned)
The array to hold the returned co-ordinates.
STATUS = INTEGER (Given and Returned)
The global status.