EVRIModel Objects and Faq import three-way data: Difference between pages

From Eigenvector Research Documentation Wiki
(Difference between pages)
Jump to navigation Jump to search
imported>Jeremy
 
imported>Bob
No edit summary
 
Line 1: Line 1:
==Introduction==
===Issue:===


EVRIModel Objects provide access to the [[Standard Model Structure]] content of all models and provide some easy-to-use methods and properties for building, manipulating, and reviewing models from Matlab's command line, scripts, and functions. In addition, these properties and methods are available from [[Solo_Predictor_Script_Construction|Solo Scripting]] when using [[Solo_Predictor_User_Guide|Solo_Predictor]] and Solo_Server. This page describes the various modes, methods, and properties of EVRIModel objects, here shortened to just "model objects".
How do I import three-way data into Solo or PLS_Toolbox?


Model objects have three distinct states:
===Possible Solutions:===


# [[#Building_from_Uncalibrated_Model_Objects|'''Empty Models''']] - Empty models can be populated with data to analyze, "meta parameters" (model building settings), and other modeling options, then models can be calibrated or built from those settings.
'''Solution 1) Built in EEM importers :'''  
# [[#Working_With_Calibrated_Models|'''Calibrated Models''']] - Calibrated models contain all the model results and parameters necessary to apply that model to new data. Plots and other information can be obtained from calibrated models.
# [[#Working_With_Applied_Models_.28Predictions.29|'''Applied Models''']] - When a calibrated model is applied to new data, the result is a prediction or "applied model". This object contains all the results from applying the model to the new data. Plots and other information can be obtained from applied models.


In addition, there are a number of [[#General_Model_Properties_and_Methods|general properties and methods]] which are available for all model states which are useful in working with EVRIModel objects.
If applicable to your file type, use one of the built in EEM importers. There are importers for EEM data from Hitachi, Shimazdu, Horiba and Jasco. Please see this wiki entry for more information on [[Data_Importing_Formats | Data Importing Formats]]


==Working with Model Objects in Matlab and Solo Scripting==
EEM data needs be configured in a specific way such that:


EVRIModels are standard Matlab objects which are manipulated using the dot notation to access properties and methods. For example, to retrieve the "model type" (modeltype) property from a model, you give the object (a.k.a. variable) name followed by .modeltype. All examples here will assume that the model is stored in a variable named "model".
* '''mode 1''' corresponds to '''samples'''


<pre>model.modeltype</pre>
* <div>'''mode 2''' corresponds to '''emission'''</div>


Most object methods can be accessed in the same way:
* <div>'''mode 3''' corresponds to '''excitation'''</div>


<pre>model.plotscores</pre>
The built-in EEM importers will handle this configuration automatically. When importing manually (see below), further manipulation will likely be necessary. Use the Transform &rarr; Permute modes and Transform &rarr; Reshape smenu items to modify your imported data as appropriate.


Some methods (<tt>.apply</tt> and <tt>.crossvalidate</tt>, for example) also require for additional inputs. These are passed in parenthesis after naming the method:
'''Solution 2) For three-way data with few slabs:'''


<pre>model.apply(newdata)</pre>
<ol style="list-style-type:lower-alpha">
  <li>Import the data slabs into the workspace (browser). The workspace browser is available from the main analysis user interface from the menu item FigBrowser.</li>
  <li>Each slab, i.e. each matrix of data is imported individually. Hence, if you have a '''10x8x3''' array, you will import three slabs each of size '''10x8'''.</li>
  <li>Use the mouse to drag slab two onto slab one. In the window that opens choose Augment and then choose augment in the Slabs direction.</li>
  <li>A two-slab three-way array has now replaced the first data matrix. More slabs can be added in the same fashion.</li>
</ol>


===Displaying Contents===
Alternatively, you may also open one slab in the dataset editor and then add additional slabs using File &rarr; Import. After selecting the next slab to import, answer the same questions as in step c above. Repeat for each slab.


At the Matlab command line (but not in Solo Scripting), you can view the contents of a model object by simply typing its name or by using the <tt>.disp</tt> method. When viewing content, there are several ways to view the model:
'''Solution 3) For larger three-way data:'''
# By Description (Desc.) : this view shows you a text description of the type of model, how it was built, and a summary of its results.
# By Contents : this view contains the raw field information from the model. Users of previous versions of PLS_Toolbox will recognize this as the previous standard display.


At the Matlab command window, you can turn either one of these sections on or off by clicking the [on] or [off] hyperlinks in the top display line (shown as <font color="#0000ee"><u>underlined blue</u></font> text below)
In the DataSet editor, you can import a full three-way array if you have it organized as a two-way matrix. Upon importing the two-way data, you can reshape to a three-way array using the menu item: Transform &rarr; Fold into 3-way.


    PCA Model Object (Desc. ON/<font color="#0000ee"><u>[off]</u></font>  Contents ON/<font color="#0000ee"><u>[off]</u></font>)
For example, you have the above matrices (three slabs) in one table/matrix:


==Building from Uncalibrated Model Objects==
  [ Slab1;
  Slab2;
  Slab3 ]


When a model object has been initially created, it contains no data and no results. Many model objects' properties can then be populated with data, meta-parameters, and other settings (options) which can then be used with the <tt>.calibrate</tt> method to build a calibrated model. The <tt>.inputs</tt> property lists the specific properties that can be set for a given model type.
hence have the three slabs below each other. Upon importing, use the menu option described above to "Fold into 3-way" and choose three as the number of slabs and the data will be rearranged accordingly. If you are familiar with the MATLAB function <code>reshape</code>, you may also use Transform &rarr; Reshape for other types of rearrangements.  


:'''NOTE:''' Some model types do NOT support calibration in this manner. In these cases, use the <tt>.cancalibrate</tt> property to determine if it allows calibration directly (1) or if it requires a call to the function named in ''modeltype'' (0). In addition, the model will clearly show the state in its display at the command line with a statement to "See _____ function to calibrate." In these cases, the only way to create a calibrated model is to access the named function directly.
Note: the result of this command will give you slabs in the 3rd mode of the DataSet. If these slabs are separate samples (such as with EEMs), you'll want to use the Transform &rarr; Permute menu to reorder the dimensions. For example, permuting to the order [3 2 1] would swap the order of the 1st and 3rd modes, putting slabs as the first mode.  


===Example===


The following is an example which would build a PCA model from the data stored in the <tt>data</tt> variable with 3 principal components:
'''Still having problems? Please contact our helpdesk at [mailto:helpdesk@eigenvector.com helpdesk@eigenvector.com]'''


<pre>
[[Category:FAQ]]
model = evrimodel('pca');
model.x = data;
model.ncomp = 3;
model.calibrate;
</pre>
 
 
===Uncalibrated Model Properties===
 
The properties of an uncalibrated model depend on the model type. Typically, a value can be provided for the data to model, plus some number of "meta-parameters" which define aspects of how the model will be built. The list of values available is indicated by the .inputs property. All models which are calibratable (<tt>.cancalibrate</tt> is equal to 1) allow modification of the <tt>.display</tt> and <tt>.plots</tt> properties.
 
The properties available for a given calibratable model type will correspond to the function of the same name as the model type. For example, the "LWR" model type has the properties: <tt>x</tt>, <tt>y</tt>, <tt>ncomp</tt>, and <tt>npts</tt>. These are identical to the inputs listed for the LWR function as described on the inputs section of the [[Lwr#Inputs|LWR documentation page]].
 
The properties which are generally available for all model types are listed below.
 
====Model Status Properties (Read-Only)====
 
{| border="1" cellpadding="5" cellspacing="0"  style="margin-left:3em"
|-
|valign="top" |
<tt>.cancalibrate</tt>
| Returns (1) if the model contains a modeling building definition (see Empty Model description, below), or (0) if the model does not contain a definition and must be calibrated using the function defined in the modeltype property.
|-
|valign="top" |
<tt>.inputs</tt>
| Returns a cell array of strings indicating which properties can be set for the model in its current state. Most often this is used when a model is in an uncalibrated state and this property will indicate what parameters and data fields are available to the user to assign before calibrating the model.
|-
|valign="top" |
<tt>.validmodeltypes</tt>
| Returns a cell array of strings listing the model types which are currently valid for assignment to the <tt>.modeltype</tt> field.
|}
 
&nbsp;
 
====Modifiable Properties====
{| border="1" cellpadding="5" cellspacing="0"  style="margin-left:3em"
|-
|valign="top" |
<tt>.modeltype</tt>
| Returns the short "keyword" model type of the current model (or empty string if the model type has not been set). This keyword most often is linked to the PLS_Toolbox function that created the given model. This can be assigned to any model type listed in the <tt>.validmodeltypes</tt> property.
|-
|valign="top" |
<tt>.display</tt>
| String property indicating 'on' if command-line display should be given when calibrating or applying a model and 'off' if no display should be given.
* ''''on'''' : Display command-line output
* ''''off'''' : Do not display any output
|-
|valign="top" |
<tt>.plots</tt>
| String property indicating 'final' if plots should be displayed after calibrating or applying a model and 'none' if no plots should be displayed.
* ''''final'''' : Generate plots (if possible)
* ''''none'''' : Do not generate any plots
|}
 
&nbsp;
 
===Uncalibrated Model Methods===
 
Both of the methods below return a model object. In Matlab, when no output is requested, the model object is stored back into the same object invoked. In Solo Scripting, these methods require an output variable, usually the same model object being built from. For example: <tt>m = m.calibrate</tt>
 
{| border="1" cellpadding="5" cellspacing="0"  style="margin-left:3em" |-
|-
|valign="top" |
<tt>.calibrate</tt>
| Build the model based on the current meta-parameters and options.
|-
|valign="top" |
<tt>.crossvalidate(''cvi'',''ncomp'')</tt>
| Build the model and cross-validate with the supplied conditions. ''cvi'' is the cross-validation splitting as described for cvi in [[crossval]] (default = venetian blinds with square-root of the number of samples as splits). ''ncomp'' is the number of components (default = maximum number available).
|}
 
&nbsp;
 
==Working With Calibrated Models==
 
Once calibrated, a model object contains all the results (relevant to the model type) derived from the modeled data. The object also has all the information necessary to apply that model to new data. For many models, methods exist for plotting parts of the model (scores, loadings, eigenvalues, etc.)
 
Whether or not a model has been calibrated can be determined by the <tt>.iscalibrated</tt> property which will be true (1) when the model is calibrated. If the object is a prediction from a model, its <tt>.isprediction</tt> property will be true (1) indicating it cannot be applied to new data (only the original, calibrated model can be applied).
 
===Example===
 
Given a model which has already been calibrated (either by using the calibrate method, or by calling one of the [[Modeling_Function_Overview|model building functions]] directly), the following would produce a plot of the scores for the model:
 
  model.plotscores
 
or obtain a DataSet object containing those scores:
 
  dso = model.plotscores;
 
Extracting the Hotelling's T<sup>2</sup> statistic for the first 5 samples would be done using:
 
  model.t2(1:5)
 
Applying the model to new data in the variable <tt>x_new</tt> could be done using:
 
  prediction = model.apply(x_new);
 
===Calibrated Model Properties===
 
The properties available in a calibrated model depends on the model type. Many of the properties are listed in the [[Standard Model Structure]] documentation. In Matlab, all fields available can be found by using "tab completion" (type the name of the variable containing the model plus a period, then press the [Tab] key) or by using the fieldnames() function.
 
In addition to the properties (fields) listed in the Standard Model Structure information, the following "shortcut" fields exist as an easy way to access properties usually embedded in the object. Note that not all of these fields exist for all model types:
 
The following properties are available for many models once they have been calibrated and represent "shortcut" methods into the Standard Model Structure fields or other model analysis methods. See also the <tt>.display</tt> and <tt>.plots</tt> properties described in the [[#Modifiable_Properties| Uncalibrated Model Properties (Modifiable Properties) section]]
 
{| border="1" cellpadding="5" cellspacing="0" style="margin-left:3em"
|-
|valign="top" |
<tt>.detail</tt>
| As described in the [[Standard Model Structure]] pages, this field contains model-specific statistics, results, and parameters of the model. The contents are highly varied. For ease of use, any field within the <tt>.detail</tt> property can be accessed ''without'' the <tt>.detail</tt> prefix (i.e. by requesting the value directly from the "top-level" model object. For example:  <tt>model.preprocessing</tt> is identical to <tt>model.detail.preprocessing</tt>.
|-
|valign="top" |
<tt>.iscalibrated</tt>
| Returns (1) if the model has been calibrated or applied and (0) if the model is in the "empty" state and has not been calibrated.
|-
|valign="top" |
<tt>.loadings</tt>
| Returns the x-block loadings as simple matrix (equivalent to <tt>.loads{2,1}</tt>)
|-
|valign="top" |
<tt>.ncomp</tt>
| Returns the number of components (PCs, LVs, etc) used in the model. For model types that do not have an adjustable parameter for number of components, a value of one (1) will be returned.
|-
|valign="top" |
<tt>.prediction</tt>
| Returns the property most associated with "predictions" for the given model type. Model types are:
* Decomposition (PCA, MCR, etc) - returns x-block scores for each sample (<tt>.loads{1,1}</tt>)
* Regression (PLS, PCR, SVM, etc) - returns y-block predictions (known as y_hat, usually <tt>.pred{2}</tt>)
* Classification (PLSDA, SVMDA, KNN, etc) - returns the single-class assignment for each sample as a class ID string (<tt>.classification.inclass</tt> indexed into the class ID lookup <tt>.classification.classids</tt>)
|-
|valign="top" |
<tt>.q</tt>
| Returns the x-block sum squared residuals for each sample (<tt>.ssqresiduals{1}</tt>)
|-
|valign="top" |
<tt>.qcon</tt>
| ''See methods below''
|-
|valign="top" |
<tt>.scores</tt>
| Returns the x-block scores for each sample (<tt>.loads{1,1}</tt>)
|-
|valign="top" |
<tt>.t2</tt>
| Returns the Hotelling's T<sup>2</sup> for the x-block (<tt>.tsqs{1}</tt>)
|-
|valign="top" |
<tt>.tcon</tt>
| ''See methods below''
|-
|valign="top" |
<tt>.uniqueid</tt>
| Returns a unique ID identifying this model based on its model type, author, and build time/date.
|-
|valign="top" |
<tt>.x</tt>
| Returns the original x-block data (when available)
|-
|valign="top" |
<tt>.xhat</tt>
| Returns the reconstructed x-block (x_hat, see [[datahat]])
|-
|valign="top" |
<tt>.y</tt>
| Returns the original y-block data (when available)
|-
|valign="top" |
<tt>.yhat</tt>
| Returns the estimated y-block (y_hat, as estimated by the model)
|}
 
===Calibrated Model Methods===
 
The following methods are available when a model has been calibrated.
 
{| border="1" cellpadding="5" cellspacing="0"  style="margin-left:3em"
|-
|valign="top" |
<tt>.apply(x_new,''y_new'',''options'')</tt>       
| Applies the model to the data  <tt>x_new</tt> and returns a [[#Working_With_Applied_Models_.28Predictions.29|prediction structure]]. If <tt>''y_new''</tt> is supplied (and is appropriate for the model type, e.g. the model is a regression model), this data will be used as validation/test values to compare predictions against. If <tt>''options''</tt> is supplied, it is passed into the model prediction function (allowing modification of some parameters.).
:'''Note:''' The [[#Modifiable_Properties|<tt>.plots</tt> and <tt>.display</tt> properties]] of a model will be used when using this method. If enabled, the method will show plots and/or command-line display as requested. The values in these properties will always override any values passed in the <tt>''options''</tt> input to the <tt>.apply</tt> method.
|-
|valign="top" |
<tt>.crossvalidate(x,''cvi'',''ncomp'')</tt>       
| When cross-validation has not been done when building a model, this method can be used to cross-validate a model (with the conditions used to build it) and store the results in the model object. This is a similar method to the one used with the [[#Uncalibrated_Model_Methods|Uncalibrated Model Methods]] except that it generally ''requires'' the x-block data be provided in the inputs (since most models do not keep the original calibration x-block data in the calibrated model structure.) The <tt>''cvi''</tt> and <tt>''ncomp''</tt> inputs are [[#Uncalibrated_Model_Methods|as defined above]].
:'''Note:''' The [[#Modifiable_Properties|<tt>.plots</tt> and <tt>.display</tt> properties]] of a model will be used when using this method. If enabled, the method will show plots and/or command-line display as requested.
|-
|valign="top" |
<tt>.ploteigen</tt>   
|With no outputs, this method generates a plot of the eigenvalues or other  statistics associated with changing the number of components in the model (e.g. RMSEC, misclassification rates) for the given model. With an output, no plot is generated but the DataSet object containing the data that would have been plotted is returned.
|-
|valign="top" |
<tt>.plotloads</tt>   
|With no outputs, this method generates a plot of the loadings (including all variable-specific statistics and results) for the given model. With an output, no plot is generated but the DataSet object containing the loadings is returned.
|-
|valign="top" |
<tt>.plotscores</tt>   
| With no outputs, this method generates a plot of the scores (including all sample-specific statistics and results) for the given model. With an output, no plot is generated but the DataSet object containing the scores is returned.
 
 
|-
|valign="top" |
<tt>.qcon(x)</tt>
| Returns the Q contributions (matrix of x-block residuals for each sample). For most model types, this method ''requires'' input of the x-data for which the q residuals should be calculated. (see [[qconcalc]])
|-
|valign="top" |
<tt>.tcon(''x'')</tt>
| Returns the Hotelling's T<sup>2</sup> contributions (scaled matrix of x-block projections into the model for each sample.) If the ''x'' input is omitted, the contributions for the calibration data are returned. If ''x'' is supplied, the contributions for the supplied x-data are calculated. (see [[tconcalc]])
 
|}
 
&nbsp;
 
==Working With Applied Models (Predictions)==
 
When a model is applied to new data, the output is an applied model, also known as a prediction object. The object type itself is still an EVRIModel Object and nearly all of the methods and properties that were available [[#Working_With_Calibrated_Models|when working with a calibrated model]] are available with an applied model. The most notable difference is that any plots or sample-specific results extracted from the model will be for the data to which it was applied instead of the calibration data. For example, when a model which calculates scores is applied to new data, the resulting EVRIModel Object will contain a <tt>.scores</tt> property that is the scores calculated for the new data.
 
Whether a model object is a calibrated model or a model prediction can be determined by looking at the <tt>.isprediction</tt> field. Note that a prediction object cannot be applied to new data. Only the original model can be applied. However, if a model has been applied using the <tt>.apply</tt> method of a model, the original model is generally stored in the <tt>.parent</tt> field so the model could be re-applied using:  <tt>pred2 = pred.parent.apply(x_new2)</tt> where <tt>x_new2</tt> is new(er) data to apply the original model to.
 
===Applied Model Properties===
{| border="1" cellpadding="5" cellspacing="0" style="margin-left:3em"
|-
|valign="top" |
<tt>.isprediction</tt>
| Returns (1) if the model contains a prediction from applying a calibrated model to new data and (0) if the model is just "calibrated" or "empty".
|-
|valign="top" |
<tt>.parent</tt>
| When a model has been applied to new data using the <tt>.apply</tt> method, this property will contain a copy of the original model object. The contents of this property are automatically used when a plotting method requires both the calibration and application data.
|}
 
&nbsp;
 
==General Model Properties and Methods==
 
In addition to the properties and methods described above, the following properties and methods are always available in a model independent of the model state or model type:
 
===Informational Properties (Read-Only)===
{| border="1" cellpadding="5" cellspacing="0"  style="margin-left:3em"
|-
|valign="top" |
<tt>.author</tt>
| String describing the author and computer on which this model was created. Usually ''user@computername''. Given a system with assigned usernames and computer names, this is equivalent to an electronic signature on a model.
|-
|valign="top" |
<tt>.content</tt>
| Returns the "raw" model information in a form that is most similar to the model structures from previous versions of PLS_Toolbox and Solo. Generally, users need not access this field directly except to provide a model in a form more similar to old models.
|-
|valign="top" |
<tt>.downgradeinfo</tt>
| Informational string explaining the purpose of the <tt>.content</tt> field.
|-
|valign="top" |
<tt>.evrimodelversion</tt><br>
<tt>.modelversion</tt>
| Returns a string containing the model version description. The model version is almost always linked to the version of PLS_Toolbox or Solo that created the given model. The two field names here are synonymous.
|-
|valign="top" |
<tt>.info</tt>
| Returns (or displays with no outputs) the text description of the model. This is the same description shown at the Matlab command line when the model is viewed with content "on". With an output, the results are returned as a cell array of strings.
|-
|valign="top" |
<tt>.isclassification</tt>
| Returns (1) if the model is a classification model that returns class assignments for unknowns or (0) if it is a decomposition or regression model type.
|-
|valign="top" |
<tt>.uniqueid</tt>
| Returns a string which uniquely identifies this model including the author, author's computer, and a date/time stamp. This uniqueid can be used to safely discriminate between different models.
|-
|valign="top" |
<tt>.validmodeltypes</tt>
| Returns a cell array of strings listing the model types which are currently valid for assignment to the <tt>.modeltype</tt> field.
|}
 
&nbsp;
 
===General Methods===
{| border="1" cellpadding="5" cellspacing="0"  style="margin-left:3em"
|-
|valign="top" |
<tt>.disp</tt>
| Displays the contents of the model. There is no output variable from this method, it only displays the information. For access to the content, see the <tt>.info</tt> method.
 
|-
|valign="top" |
<tt>.encode</tt>
| Returns m-script code which, when executed by Matlab with PLS_Toolbox, will regenerate the model contents (note: this code does not rebuild the model from raw data, but reconstitutes the content of the model from this text format description of the model.) See the [[encode]] function.
|-
|valign="top" |
<tt>.encodexml</tt>
| Returns xml descriptor of the model content. Parsing this content using the XML import functions of Solo or PLS_Toolbox (see [[parsexml]]) will regenerate the model contents from this text format description of the model.  See the [[encodexml]] function.
|-
|valign="top" |
<tt>.help</tt>
<tt>.help.predictions</tt>
| Alone without any additional sub-indexing, this method brings up the help which is most relevant for the particular model type. With the <tt>.predictions</tt> sub-field, this method returns [[Solo_Predictor_Script_Construction#Common_Return_Properties|a structure array of possible sub-fields]] that may be requested for certain properties of the current model.
|}
 
&nbsp;
 
==Backwards Compatibility==
 
In general, PLS_Toolbox and Solo models cannot be guaranteed to be backwards compatible to earlier versions of the software. This is because we may introduce a new preprocessing method, or numerical calculation option to an analysis method which simply doesn't exist in the earlier software. Although Eigenvector Research cannot guarantee that we won't make changes to our data or model formats that will "break" code which users have written, we do make every effort to make new code as compatible with old user code as much as practical. The EVRIModel Object has been similarly constructed and will, for the most part, behave much as the old PLS_Toolbox model structures. Indexing into fields and referencing models in code will appear almost identical.
 
One notable exception is that the EVRIModel Object itself is stored in a format such that a model saved in the released version of PLS_Toolbox or Solo will ''not'' be readable by a version of the software released prior to the introduction of EVRIModel objects. The only way to extract the "simple" model structure format that existed prior to the EVRIModel object is to use the [[#General_Model_Properties_and_Methods|<tt>.content</tt> property]] of the model object. This will convert the top-level model into the basic format that is nominally readable by old versions. However, it is critical to note that other model format or algorithmic changes may make this backwards compatibility impossible.
 
An additional way to extract all model objects into their non-object form is to set the 'noobject' property to 1 (one).
  setplspref('evrimodel','noobject',1)
All models (top-level models and any embedded models) loaded when that flag is enabled will be automatically extracted.
 
If backwards compatibility is truly needed, it is best to contact the [mailto:helpdesk@eigenvector.com Eigenvector Research Helpdesk].

Revision as of 10:45, 20 June 2019

Issue:

How do I import three-way data into Solo or PLS_Toolbox?

Possible Solutions:

Solution 1) Built in EEM importers :

If applicable to your file type, use one of the built in EEM importers. There are importers for EEM data from Hitachi, Shimazdu, Horiba and Jasco. Please see this wiki entry for more information on Data Importing Formats

EEM data needs be configured in a specific way such that:

  • mode 1 corresponds to samples
  • mode 2 corresponds to emission
  • mode 3 corresponds to excitation

The built-in EEM importers will handle this configuration automatically. When importing manually (see below), further manipulation will likely be necessary. Use the Transform → Permute modes and Transform → Reshape smenu items to modify your imported data as appropriate.

Solution 2) For three-way data with few slabs:

  1. Import the data slabs into the workspace (browser). The workspace browser is available from the main analysis user interface from the menu item FigBrowser.
  2. Each slab, i.e. each matrix of data is imported individually. Hence, if you have a 10x8x3 array, you will import three slabs each of size 10x8.
  3. Use the mouse to drag slab two onto slab one. In the window that opens choose Augment and then choose augment in the Slabs direction.
  4. A two-slab three-way array has now replaced the first data matrix. More slabs can be added in the same fashion.

Alternatively, you may also open one slab in the dataset editor and then add additional slabs using File → Import. After selecting the next slab to import, answer the same questions as in step c above. Repeat for each slab.

Solution 3) For larger three-way data:

In the DataSet editor, you can import a full three-way array if you have it organized as a two-way matrix. Upon importing the two-way data, you can reshape to a three-way array using the menu item: Transform → Fold into 3-way.

For example, you have the above matrices (three slabs) in one table/matrix:

 [ Slab1;
 Slab2;
 Slab3 ]

hence have the three slabs below each other. Upon importing, use the menu option described above to "Fold into 3-way" and choose three as the number of slabs and the data will be rearranged accordingly. If you are familiar with the MATLAB function reshape, you may also use Transform → Reshape for other types of rearrangements.

Note: the result of this command will give you slabs in the 3rd mode of the DataSet. If these slabs are separate samples (such as with EEMs), you'll want to use the Transform → Permute menu to reorder the dimensions. For example, permuting to the order [3 2 1] would swap the order of the 1st and 3rd modes, putting slabs as the first mode.


Still having problems? Please contact our helpdesk at helpdesk@eigenvector.com