NAME

aux_read_table -- read a text file

PROTOTYPE

void aux_read_table( FILE *fp, int iFirstRecord, int iMaxRecords, float **ppfData, int *piDim, int *piNum, char **ppcTitle, char **ppcHeader, float **ppfMin, float **ppfMax, int *piNumAxisLabels, char ***pppcAxisLabel, float **ppfAxisInfo, int **ppiBlockLen, char ***pppcRecordLabel, int iFlag, int (*pDiagnostics)(FILE*)

ARGUMENTS

FILE *fp
file to use
int iFirstRecord
record to start with
int iMaxRecords
max nr of records to read (0=all)
float **ppfData
adr of newly allocated array holding data that were read
int *piDim
dim of records read
int *piNum
actual nr of records read
char **ppcTitle
returns newly allocated title, "" if no title was read.
char **ppcHeader
returns newly allocated header text, "" if no header was read.
float **ppfMin
adr of ptr to vector of lower limits (one for each dimension)
float **ppfMax
adr of ptr to vector of upper limits (one for each dimension)
int *piNumAxisLabels
ptr to nr of axis labels read in header
char ***pppcAxisLabel
adr of newly allocated ptr array with axis labels ("#0", "#1" .) if no axis labels were read
float **ppfAxisInfo
if !NULL, adr of newly allocated ptr array holding the following three values for each axis: fMinRange: fMaxRange: lower/upper limit of range (returns fMin/fMax, if unspecified ) iNumBins : nr of discretization cells (returns 1, if unspecified)
int **ppiBlockLen
if specified, returns newly allocated array holding for each consecutive (ie., not interrupted by a blank line) block of data lines its nr of lines. El 0 will hold nr of blocks found.
char ***pppcRecordLabel
if specified, interprete column 0 not as data, but as record label field and returns adr of newly allocated ptr array holding record labels read from column 0
int iFlag
if 1, date order is days first, otherwise if -1, date order is months first
int (*pDiagnostics)(FILE*
- not documented in source --

FILE

/local/homes/rhaschke/nst7/man/../o.linx86//../foldersrc/aux_read_table.c