Asfreadr: Difference between revisions

Revision as of 14:33, 16 June 2015

Reads an AIT data file.

x = asfreadr(filename,options)

x = asfreadr({'filename' 'filename2'},options)

ASFREADR reads an AIT spectral file (ASF, AIF, and BKH extensions).

filename = a text string with the name of a spectral file or a cell of strings of filenames.
- If filename is omitted or blank, the user will be prompted to select a file graphically.
- If filename is an empty cell {}, the user will be prompted to select a folder and then one or more AIT files in the identified folder.

If input is a single file, or multiple files containing data that can be combined (same number of data points, same x-axis range, same type of data), the output is a dataset object
If the input consists of multiple files, but the data cannot be combined, the output is a cell array with a dataset object for each input file (see the nonmatching option defined above)

options = a structure array with the following fields:

nonmatching: [ 'error' |{'matchvars'} 'cell'] governs behavior when multiple files are being read which cannot be combined due to mismatched types, sizes, etc.

'matchvars' returns a dataset object,

'cell' returns cell (see outputs, below),

'error' gives an error.

multiselect : [ 'off' | {'on'} ] governs whether file selection dialog should allow multiple files to be selected and imported. Setting to 'off' will restrict user to importing only one file at a time.

@@ Line 29: / Line 29: @@
 ''options'' =  a structure array with the following fields:
-* '''nonmatching''': [ 'error' | {'cell'} ], defines action taken when the x-axes or data types of multiple spectra being read do not match. The default choice, 'cell', returns a cell array where each element is a dataset object with data from a single file.  The other choice, 'error', will return an error when the files do not match.
+* '''nonmatching''': [ 'error' |{'matchvars'} 'cell']  governs behavior when multiple files are being read which cannot be combined due to mismatched types, sizes, etc.
+::: 'matchvars' returns a dataset object,
+::: 'cell' returns cell (see outputs, below),
+::: 'error' gives an error.
 * '''multiselect''' : [ 'off' | {'on'} ] governs whether file selection dialog should allow multiple files to be selected and imported. Setting to 'off' will restrict user to importing only one file at a time.