KPG1_FLCOx

Obtains a list of co-ordinates from a text file

Description:

This routine obtains a list of n-dimensional co-ordinates for a series of positions. The text file should contain on each line a set of free-format co-ordinates that defines a position, except for comment lines denoted by a hash or shriek in column 1. The file is opened using the supplied parameter. A pass is made through the file to see how many records it contains. Dynamic workspace is reserved to contain the co-ordinates, and the file is then rewound. Another pass is made through the file to read the co-ordinate values which are then stored in the workspace. Pointers to the workspace are returned. This workspace should be released by calling PSX_FREE when it is no longer needed.

Invocation

CALL KPG1_FLCOx( PNAME, NDIM, POSCOD, NPOINT, IPCO, LBND, UBND, STATUS )

Arguments

PNAME = CHARACTER ∗ ( ∗ ) (Given)
Name of the parameter with which to associate the text file.
NDIM = INTEGER (Given)
The number of co-ordinate dimensions to read from the text file.
POSCOD( NDIM ) = INTEGER (Given)
The column numbers of the co-ordinate information in order x, y, z, etc. These must be positive.
NPOINT = INTEGER (Returned)
The number of co-ordinate sets specified in the text file.
IPCO = INTEGER (Returned)
A pointer to workspace of type <HTYPE > and size NDIM by NPOINT holding the NDIM co-ordinates of each point.
LBND( NDIM ) = ? (Returned)
The lower bounds of the input data, i.e. the minimum value for each co-ordinate.
UBND( NDIM ) = ? (Returned)
The upper bounds of the input data, i.e. the maximum value for each co-ordinate.
STATUS = INTEGER (Given and Returned)
The global status.

Notes: