Release Notes Version 7 0 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
(Created page with "Version 7.0 of PLS_Toolbox and Solo was released in October, 2012. For general product information, see [http://www.eigenvector.com/software/pls_toolbox.htm PLS_Toolbox Product ...")
 
imported>Bob
No edit summary
 
Line 1: Line 1:
Version 7.0 of PLS_Toolbox and Solo was released in October, 2012.
===Issue:===


For general product information, see [http://www.eigenvector.com/software/pls_toolbox.htm PLS_Toolbox Product Page]. For information on Solo, see [http://www.eigenvector.com/software/solo.htm Solo Product Page].
How do I import three-way data into Solo or PLS_Toolbox?


This release was done in conjunction with [[Release_Notes_MIA_Toolbox_Version_2_8|MIA_Toolbox / Solo+MIA version 2.8]]
===Possible Solutions:===


(back to [[Release Notes PLS Toolbox and Solo]])
'''Solution 1) Built in EEM importers :'''
==New Features==


===[[AnalysisWindow_Layout|Analysis Window]]===
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]]
* Feature


===[[WorkspaceBrowser_Layout|Workspace Browser]] ===
EEM data needs be configured in a specific way such that:
* Feature


===[[Importing_Data|Import / Export]]===
* '''mode 1''' corresponds to '''samples'''
* [[hjyreadr]] - Improved ability to install and manage ActiveX object.


===[[Plot_Controls|Plot Controls and Visualization Tools]]===
* <div>'''mode 2''' corresponds to '''emission'''</div>
* Selectable


===[[Dataset_editor|DataSet Editor]]===
* <div>'''mode 3''' corresponds to '''excitation'''</div>
* Plot


===Other Method Improvements===
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.
* [[Sample_Classification_Predictions|Classification methods]] - include "Class Pred Member - multiple" indicating when a sample is being assigned to more than one class.


==New Command-line Features and Functions==
'''Solution 2) For three-way data with few slabs:'''


*''Full Support for Matlab R2012b''
<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>


===Command-line Tool Changes===
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.


* ''Quick Reference Card'' -New quick reference card ( PLS_Toolbox_Quick_Reference.pdf )
'''Solution 3) For larger three-way data:'''  


* [[chitest]] -add distribution name and function name to chitest outputs (making it much easier to apply the results).
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.  
* [[coreanal]] -updated coreanal.m to be able to provide a list of important core values (new optional second output).
* [[ils_esterror]] -Various improvements to allow different types of error estimates.
* [[svmoc]] -add support to plot scores from SVM One Class models.
* [[DataSet Object]] - New methods added:
*:* FINDSET -Locate a set within a label field (axisscale,label,class) in a DataSet.
*:* LISTSETS -For a given field and mode list the sets available.
*:* SEARCH -Search for given term in a dso field, mode, and set.
*:* UPDATESET -Add/update a label field (axisscale,label,class) in a DataSet.


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


===Misc New Functions===
  [ Slab1;
:[[classsummary]] -
  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 <code>reshape</code>, you may also use Transform &rarr; 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 &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.
 
 
'''Still having problems? Please contact our helpdesk at [mailto:helpdesk@eigenvector.com helpdesk@eigenvector.com]'''
 
[[Category:FAQ]]

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