ascin in lines colaxes=? coldata=? [start=? step=? end=?] out=?
A S C I N The user specifies in which columns the different items are to be found. A range of line numbers to be used can be specified. Comment lines may be interspersed in this line range, if they are marked by an exclamation mark in the first or second character. All columns leftward of the rightmost used column must be numeric, non-numeric data may follow in further columns. Up to 132 characters are read from table lines. Numbers are read as _REAL. If the result is one-dimensional, the axis values will be taken literally to define a grid, which in general may be non-linear and non-monotonic. If the result is multi-dimensional, the routine will guess from the table a grid that is linear in all directions. The parameter system is consulted to confirm or modify the suggested grid. The data value read from a line will be stored into exactly one output pixel, if and only if the table coordinates match that pixel's coordinate to within a specified fraction of the pixel step. Pixels for which no data are in the table are assigned the bad value. Table data equal to a specified "alternative bad value" are replaced by the bad value before insertion into the data set. Where more than one table line corresponds to the same pixel, the pixel is assigned the last value from the table. That is, later specifications of the same pixel override previous ones.
ascin in [1,9999] colaxes=[1,2] coldata=[3,4] start=[0,0] end=[2.5,5] step=[0.1,1] out=out This will read the data from the ASCII file IN, using line numbers 1 to 9999 (or till end of file if there are less lines in IN). The 1st axis data are taken from the first column, the 2nd axis data from the second column. The image data are taken from the 3rd column and their errors from the 4th column. The routine tries to store the table data into a grid with the 1st axis running from 0 to 2.5 in steps of 0.1 (26 pixels) and the 2nd axis running from 0 to 5 in steps of 1 (6 pixels). If a coordinate pair from columns 1&2 matches any pixel centre well enough, the data from columns 4&5 are entered into the corresponding element of the data and errors array. The data file is OUT. ascin in out [25,39] colaxes=5 coldata=[3,0] Here the output is one-dimensional and without errors array (thus the zero in COLDATA). Only lines 25 to 39 from IN are used. The axis data are from the 5th column and the spectrum data from the 3rd column. (Note that columns 1, 2 and 4 must contain numeric data.) The axis grid need not be specified. The axis values from the table will be taken literally to form a grid that is in general non-linear and non-monotonic.
FIGARO A general data reduction system