Mtfreadr: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Jeremy
(Importing text file)
 
imported>Jeremy
(Importing text file)
Line 6: Line 6:
===Description===
===Description===
Generic reader for AdventaCT Multi-Trace Format (MTF) files. Input is an optional filename filename If omitted, user is prompted to locate file. An optional input combine is a string instructing how to combine multiple traces found in the mtf file:
Generic reader for AdventaCT Multi-Trace Format (MTF) files. Input is an optional filename filename If omitted, user is prompted to locate file. An optional input combine is a string instructing how to combine multiple traces found in the mtf file:
* 'none' :  returns a cell array containing datasets formed from each of the separate traces located in the MTF file.  
* ''''none'''' :  returns a cell array containing datasets formed from each of the separate traces located in the MTF file.  
* 'truncate' :  {default} truncates all traces to the shortest trace's length.  
* ''''truncate'''' :  {default} truncates all traces to the shortest trace's length.  
* 'pad' :  pads all traces with NaN's to the longest trace's length.
* ''''pad'''' :  pads all traces with NaN's to the longest trace's length.
* 'stretch' :  uses linear interpolation to stretch all traces to the longest trace's length.
* ''''stretch'''' :  uses linear interpolation to stretch all traces to the longest trace's length.
The output data is either a DSO (3-way DSO if multiple traces were found) or a cell array containing all the trace DSOs. Note that if a given trace does not have a sufficient number of columns in all rows, column contents may be scrambed from the dropped point down. In this situation, a warning will be given.
The output data is either a DSO (3-way DSO if multiple traces were found) or a cell array containing all the trace DSOs. Note that if a given trace does not have a sufficient number of columns in all rows, column contents may be scrambed from the dropped point down. In this situation, a warning will be given.
===See Also===
===See Also===
[[areadr]], [[spcreadr]], [[xclgetdata]], [[xclputdata]], [[xclreadr]]
[[areadr]], [[spcreadr]], [[xclgetdata]], [[xclputdata]], [[xclreadr]]

Revision as of 20:56, 2 September 2008

Purpose

Read / Import AdventaCT Multi-Trace Format (MTF) files.

Synopsis

data = mtfreadr(filename,combine)
[data,lotinfo] = mtfreadr(filename,combine)

Description

Generic reader for AdventaCT Multi-Trace Format (MTF) files. Input is an optional filename filename If omitted, user is prompted to locate file. An optional input combine is a string instructing how to combine multiple traces found in the mtf file:

  • 'none' : returns a cell array containing datasets formed from each of the separate traces located in the MTF file.
  • 'truncate' : {default} truncates all traces to the shortest trace's length.
  • 'pad' : pads all traces with NaN's to the longest trace's length.
  • 'stretch' : uses linear interpolation to stretch all traces to the longest trace's length.

The output data is either a DSO (3-way DSO if multiple traces were found) or a cell array containing all the trace DSOs. Note that if a given trace does not have a sufficient number of columns in all rows, column contents may be scrambed from the dropped point down. In this situation, a warning will be given.

See Also

areadr, spcreadr, xclgetdata, xclputdata, xclreadr