Key GUIs and DataSet Construction: Difference between pages

From Eigenvector Research Documentation Wiki
(Difference between pages)
Jump to navigation Jump to search
imported>Jeremy
 
imported>Mathias
 
Line 1: Line 1:
==Introduction==
==Getting Started==
Most of the higher-level data analysis tools can be accessed through Graphical User Interfaces (GUIs) in PLS_Toolbox. In many cases a GUI can make data analysis faster and easier to perform and interpret than using the command line analogs.
In general, data is stored in a dataset object.


PLS_Toolbox is organized around 4 main GUI tools. Each tool is dedicated to a specific step in the data analysis process.


[[Image:PLSTBGUIDiagram.png|GUI Organization Diagram]]


#The [[Workspace Browser]] is the Solo/PLS_Toolbox "desktop" environment. Here one has access to all loaded data, available analysis methods, the DataSet Editor, and other top level tools. With its "drag and drop" functionality, a user can quickly begin a number of data analysis tasks.
 
#The [[DataSet Editor]] is the primary data-handling GUI in PLS_Toolbox and Solo. It provides a variety of functions and tools for loading, editing, and saving data. As its name suggests, the object used in PLS_Toolbox and Solo for managing data is the DataSet Object.
 
#The [[Analysis GUI]] is the core interface with PLS_Toolbox and Solo data modeling and exploration functions. This is where you will create and explore your models.
==From a GUI==
#The PlotGUI [[Plot Controls]] interface is the principal data visualization tool for PLS_Toolbox. It provides a vast number of tools for labeling, manipulating, and publishing plots generated using PLS_Toolbox and Solo.
 
Using PLS_Toolbox and Solo, it is easy to import data into a dataset object using the data importer.  From the workspace browser select File/Import Data to launch the GUI.
 
 
Alternatively this can be acheived by dragging the desired file into the Workspace Browser.  In the case of text based file formats such as CSV, this will launch the following window.
 
[[Image:Text Import.jpg|||Scores Plot on Image]]
 
==From the MATLAB Command Line==
 
 
From the command line, the easiest way to create a dataset is to pass an array to the dataset function. First we will create an array of data to be passed to the dataset function.  
 
<pre>
>> t    = [0:0.1:10]';
>> x    = [cos(t) sin(t) exp(-t)];
>> data = dataset(x)
data =
      name: x
      type: data
      date: 23-May-2016 11:24:53
    moddate: 23-May-2016 11:24:53
      data: 101x3 [double]
      label: {2x1} [array (char)]
              Mode 1  [: ]
              Mode 2  [: ]
  axisscale: {2x1} [vector (real)] (axistype)
              Mode 1  [: ] (none)
              Mode 2  [: ] (none)
      title: {2x1} [vector (char)]
              Mode 1  [: ]
              Mode 2  [: ]
      class: {2x1} [vector (double)]
              Mode 1  [: ]
              Mode 2  [: ]
    classid: {2x1} [cell of strings]
    include: {2x1} [vector (integer)]
              Mode 1  [: 1x101]
              Mode 2  [: 1x3] 
    history: {1x1 cell} [array (char)]
      OTHER: [View Class Summary]
</pre>
 
Alternatively we could start with an empty dataset and assign the the array x to its data field.
 
<pre>
newdata = dataset;
newdata.data = x;
</pre>
 
Similarly we may set the other fields of the dataset object individually.
 
<pre>
vars = {'cos(t)';'sin(t)';'exp(-t)'};
newdata.author  = 'Data Manager';        %sets the author field
newdata.label{2} = vars;                  %sets the labels for columns = dimension 2
newdata.labelname{2} = 'Variables';      %sets the name of the label for columns
newdata.axisscale{1} = t;                %sets the axis scale for rows = dimension 1
newdata.axisscalename{1} = 'Time';        %sets the name of the axis scale for rows
newdata.title{1}        = 'Time (s)';    %sets the title for rows
newdata.titlename{1}    = 'Time Axis';  %sets the titlename for rows
newdata.title{2} = 'f(t)';                %sets the title for columns
newdata.titlename{2} = 'Functions';      %sets the titlename for columns
</pre>
 
==Creating 3-Way Data==
 
Perhaps the easiest way to import 3-way data is to use the import data GUI.

Revision as of 12:03, 23 May 2016

Getting Started

In general, data is stored in a dataset object.



From a GUI

Using PLS_Toolbox and Solo, it is easy to import data into a dataset object using the data importer. From the workspace browser select File/Import Data to launch the GUI.


Alternatively this can be acheived by dragging the desired file into the Workspace Browser. In the case of text based file formats such as CSV, this will launch the following window.

Scores Plot on Image

From the MATLAB Command Line

From the command line, the easiest way to create a dataset is to pass an array to the dataset function. First we will create an array of data to be passed to the dataset function.

>> t    = [0:0.1:10]';
>> x    = [cos(t) sin(t) exp(-t)];
>> data = dataset(x)
 
data = 
       name: x
       type: data 
       date: 23-May-2016 11:24:53
    moddate: 23-May-2016 11:24:53
       data: 101x3 [double]
      label: {2x1} [array (char)]
               Mode 1  [: ] 
               Mode 2  [: ] 
  axisscale: {2x1} [vector (real)] (axistype)
               Mode 1  [: ] (none) 
               Mode 2  [: ] (none) 
      title: {2x1} [vector (char)]
               Mode 1  [: ] 
               Mode 2  [: ] 
      class: {2x1} [vector (double)]
               Mode 1  [: ] 
               Mode 2  [: ] 
    classid: {2x1} [cell of strings]
    include: {2x1} [vector (integer)]
               Mode 1  [: 1x101] 
               Mode 2  [: 1x3]   
    history: {1x1 cell} [array (char)]
      OTHER: [View Class Summary]

Alternatively we could start with an empty dataset and assign the the array x to its data field.

newdata = dataset;
newdata.data = x;

Similarly we may set the other fields of the dataset object individually.

vars = {'cos(t)';'sin(t)';'exp(-t)'};
newdata.author   = 'Data Manager';        %sets the author field
newdata.label{2} = vars;                  %sets the labels for columns = dimension 2
newdata.labelname{2} = 'Variables';       %sets the name of the label for columns
newdata.axisscale{1} = t;                 %sets the axis scale for rows = dimension 1
newdata.axisscalename{1} = 'Time';        %sets the name of the axis scale for rows
newdata.title{1}         = 'Time (s)';    %sets the title for rows
newdata.titlename{1}     = 'Time Axis';   %sets the titlename for rows
newdata.title{2} = 'f(t)';                %sets the title for columns
newdata.titlename{2} = 'Functions';       %sets the titlename for columns

Creating 3-Way Data

Perhaps the easiest way to import 3-way data is to use the import data GUI.