Snabsreadr: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Donal
(Created page with "===Purpose=== SNABSREADR Reads Stellarnet ABS XY files. ===Synopsis=== :data = snabsreadr(filenames,options) ===Description=== Reads one or more Stellarnet ABS XY files into ...")
 
imported>Donal
No edit summary
Line 17: Line 17:
It is REQUIRED that, if multiple files are being read, they must all have
It is REQUIRED that, if multiple files are being read, they must all have
the same X range. If this is not true, the import may fail.
the same X range. If this is not true, the import may fail.
====Inputs====
* '''filenames''' = One of the following identifications of files to read:
:a) a single string identifying the ABS file to read ('example')
:b) a cell array of strings giving multiple ABS files to read({'example_a' 'example_b' 'example_c'})
:c) an empty array indicating that the user should be prompted to locate the file(s) to read ([])
====Outputs====
* '''model''' = a DataSet object with the first column of the file(s) stored as
the axisscale{2} values and subsequent column stored as row of data.
===Options===
''options'' =  an optional options structure containing one or more of the following fields:
* '''headerrows''': [2] number of header rows to expect in each file,
* '''startvar''': [] when supplied, defines the first variable to include in the output (in axisscale units). Empty reads from the
beginning of the data,
* '''endvar''': [] when supplied, defines the last variable to include in the output (in axisscale units). Empty reads to the end of the data.

Revision as of 15:14, 8 March 2011

Purpose

SNABSREADR Reads Stellarnet ABS XY files.

Synopsis

data = snabsreadr(filenames,options)

Description

Reads one or more Stellarnet ABS XY files into a DataSet object. Reads fixed-width XY ABS files in which the first column is a column of axisscale values and the second column is the values measured at the corresponding axisscale values. Returns a DataSet object with the X as the axisscale in the file and all Y columns (both in the same file and in multiple files) concatenated and transposed as rows.

It is REQUIRED that, if multiple files are being read, they must all have the same X range. If this is not true, the import may fail.


Inputs

  • filenames = One of the following identifications of files to read:
a) a single string identifying the ABS file to read ('example')
b) a cell array of strings giving multiple ABS files to read({'example_a' 'example_b' 'example_c'})
c) an empty array indicating that the user should be prompted to locate the file(s) to read ([])

Outputs

  • model = a DataSet object with the first column of the file(s) stored as

the axisscale{2} values and subsequent column stored as row of data.

Options

options = an optional options structure containing one or more of the following fields:

  • headerrows: [2] number of header rows to expect in each file,
  • startvar: [] when supplied, defines the first variable to include in the output (in axisscale units). Empty reads from the

beginning of the data,

  • endvar: [] when supplied, defines the last variable to include in the output (in axisscale units). Empty reads to the end of the data.