READA

Purpose:

Reads a single column ASCII file and returns a series.

Syntax:

READA("filename", colnum, numpoints, offset)

"filename"

-

A string. The name of ASCII file to read. If no path is given, READA searches the current working directory for the file.

colnum

-

Optional. An integer. The column to read. The column number index begins at zero. Defaults to 0.

numpoints

-

Optional. An integer. The number of points to read. Defaults to -1,  all the points in the column.

offset  

-

Optional. An integer. The starting line number of the data. Defaults to 1, the first line.

Returns:

A series.

Example:

reada("STRAIN.TS")

 

reads the ASCII file STRAIN.TS, without a header, from disk into the current Window.

Remarks:

READA ignores any header information in the data file. To retain header info, use the Import Utilities.

 

Any series can be saved as a file with WRITEA, WRITETABLE or WRITEB.

 

To read a multi-column data file, use the Import Utilities or the READTABLE function. READTABLE reads on or more columns of data and provides more extensive file reading options.

 

READA ignores any NA values in a file. READTABLE identifies and accepts NA values.

See Also:

EXPORTFILE

IMPORTFILE

READB

READTABLE

WRITEA

WRITEB

WRITETABLE