NAME:
READASCII_0
PURPOSE:
Read data from an ASCII file into an array. It is assumed that each line
with same number of entries. It can extract a sub-rectangle of region
from the ascii file.
CATEGORY:
Input/Output
CALLING SEQUENCE:
READASCII_0, Filename, Rarray, X, Y [ /DOUBLE, SKIP=skip, LINES=lines,
L_COLUMN=l_column, COLUMNS=columns , XCOL=xcol ]
INPUT:
Filename - Input file name
KEYWORD PARAMETERS:
DOUBLE - specifies output variable in double position
SKIP - skip number of lines at beginning of file
LINES - total number of lines to be read
L_COLUMN - skip number of columns from the input line
COLUMNS - total number of columns to be read from the line
XCOL - specifies the X axis column number, defualt 0
YROW - specifies the Y axis column number, defualt 3 for 2D array
OUTPUTS:
Rarray - Return the dependent variable columns read in
X - Return the column as X independent variable
Y - Return dependent variable(s) for 1D data
Return the Y independent variable for 2D data
RESTRICTIONS:
The input file must be in ASCII form. The header lines must be placed
at the beginning of the file. They can be skipped by setting the SKIP
equal to the number of header lines at beginning. Each data line must
contains the exactly same number of columns.
EXAMPLE:
READASCII_0, 'Filename', RARRAY, X, Y
MODIFICATION HISTORY:
Written by: Ben-chin K. Cha
09-16-98 bkc Allows blank lines at end of ascii file, no blank
lines allowed between data
11-23-99 bkc Use keyword XCOL to specify the column to be used
as X-axis
01-23-02 bkc Use keyword YROW to specify the line to be used
as Y-axis ( only used by 2D data array)
(See wd_readascii.pro)
NAME:
WD_READASCII
PURPOSE:
A widget program allows the user to freely read fix formatted ascii
data array from any text file. It provides text window of showing
raw ascii text file. A user uses column and row widgets controls to
extract data array from the input file, it provides options of
previewing any 1D or 2D data arrays.
CATEGORY:
Widget program
INPUT:
FILENAME - Specify the input text file, default use the file
selection dialog
OUTPUT:
READASCII_INFO - return the readascii_info data structure
KEYWORD PARAMETERS:
INPATH - return the input file path directory
GROUP - Specify the parent widget ID, close of parent widget
resulting close of this program
EXAMPLE:
wd_readascii
MODIFICATION HISTORY:
Written by: Ben-chin K. Cha
(See wd_readascii.pro)