Explode: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Jeremy
(Importing text file)
 
imported>Jeremy
Line 14: Line 14:
===Examples===
===Examples===
For the structure array x
For the structure array x
>> x.field1 = 2;
  >> x.field1 = 2;
>> x.field2 = 3;
  >> x.field2 = 3;
>> explode(x)
  >> explode(x)
Input (sdat) is not a recognized model. Exploding as regular structure
Input (sdat) is not a recognized model. Exploding as regular structure
>> whos
  >> whos
  Name        Size                  Bytes  Class
    Name        Size                  Bytes  Class
  field1      1x1                        8  double array
    field1      1x1                        8  double array
  field2      1x1                        8  double array
    field2      1x1                        8  double array
  x            1x1                      264  struct array
    x            1x1                      264  struct array
the variables field1 and field2 have been written to the base workspace.
the variables field1 and field2 have been written to the base workspace.
===See Also===
===See Also===
[[analysis]], [[modelstruct]]
[[analysis]], [[modelstruct]]

Revision as of 11:35, 2 September 2008

Purpose

Extracts variables from a structure array.

Synopsis

explode(sdat,mod,txt,out)
options = explode('options')

Description

EXPLODE writes the fields of the input structure sdat to variables in the workspace with the same variable names as the field names. If sdat is a standard model structure, only selected information is written to the workspace. Optional string input txt appends a string to the variable output names.

Options

  • options = a structure array with the following fields:
  • model: [ 'no' | {'yes'} ] interpret sdat as model if possible, and
  • display: [ 'off' | {'on'} ]} display model information.

The default options can be retreived using: options = explode('options');.

Examples

For the structure array x

 >> x.field1 = 2;
 >> x.field2 = 3;
 >> explode(x)

Input (sdat) is not a recognized model. Exploding as regular structure

 >> whos
   Name         Size                   Bytes  Class
   field1       1x1                        8  double array
   field2       1x1                        8  double array
   x            1x1                      264  struct array

the variables field1 and field2 have been written to the base workspace.

See Also

analysis, modelstruct