Snabsreadr: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Donal
No edit summary
imported>Jeremy
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
===Purpose===
===Purpose===
SNABSREADR Reads Stellarnet ABS XY files.
SNABSREADR Reads Stellarnet ABS XY files.


===Synopsis===
===Synopsis===
:data = snabsreadr(filenames,options)
:data = snabsreadr(filenames,options)


Line 18: Line 16:
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===
===Inputs====
 
* '''filenames''' = One of the following identifications of files to read:
* '''filenames''' = One of the following identifications of files to read:
:a) a single string identifying the ABS file to read ('example')
: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'})
: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 ([])
:c) an empty array indicating that the user should be prompted to locate the file(s) to read ([])


===Outputs====
===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.
* '''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===
Line 35: Line 29:


* '''headerrows''': [2] number of header rows to expect in each file,
* '''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
* '''startvar''': [] when supplied, defines the first variable to include in the output (in axisscale units). Empty reads from the beginning of the data,
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.
* '''endvar''': [] when supplied, defines the last variable to include in the output (in axisscale units). Empty reads to the end of the data.
===See Also===
[[Data Importing Formats]], [[jcampreadr]], [[spcreadr]], [[writespc]], [[xclreadr]]

Latest revision as of 09:29, 16 April 2013

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.

See Also

Data Importing Formats, jcampreadr, spcreadr, writespc, xclreadr