Plot Controls and Dataset horzcat: Difference between pages

From Eigenvector Research Documentation Wiki
(Difference between pages)
Jump to navigation Jump to search
imported>Jeremy
No edit summary
 
imported>Jeremy
m (Dataset/horzcat moved to Dataset horzcat over redirect)
 
Line 1: Line 1:
PlotGUI's Plot Controls are the primary plotting tools in PLS_Toolbox/Solo. The Plot Controls are configured to have a single small interface which contains all of the tools necessary to manipulate a particular plot. At any time there may be several plots (figures) open under "control" of the Plot Controls but only one Plot Controls window will be shown. Selecting a plot and clicking on its "gray space" (the gray margin area around the actual plot axes) will automatically bring the Plot Controls interface to the front. Likewise, you can switch between controlled plots by selecting a plot from the yellow pull-down menu at the top of the Plot Controls.
===Purpose===
 
Horizontal concatenation of DataSet objects.
The plot controls are automatically invoked when plotting data from the various [[Key GUIs]] of PLS_Toolbox and Solo, but they can also be invoked from PLS_Toolbox by typing <tt>plotgui</tt> at the MATLAB command line. For more information on using the Plot Controls from the MATLAB command line, see [[plotgui]]
===Synopsis===
 
z = [a, b, c, ... ];
<pre>>> plotgui </pre>
===Description===
 
[a b] is the horizontal concatenation of DataSet objects a and b. Any number of DataSet objects can be concatenated within the brackets. For this operation to be defined the following must be true:
[[Image:Plotgui.png|Plot Controls Figure]]
1) All inputs must be valid DataSet objects or convertible to a DataSet object.
 
2) The DataSet '.type' fields must all be the same.
PlotGUI '''Plot Controls''' Figure
3) Concatenation is along the second dimension. The first and, for multiway, remaining dimension sizes must match.
 
This is similar to matrix concatenation, but each field is treated differently. In structure notation this is:
At the top of the Plot Controls window is a Figure Selector pull-down menu, which indicates the current figure being controlled. Below this are three '''Axis Menus''', one for each of the x, y and z axes of a plot. Multiple y-axis items can be simultaneously plotted by holding down the Control key when making selections (As these plots can get confusing, a legend can be added to the plot by selecting Insert/Legend from the menus on the plot itself). Clicking the '''Select''' button will allow you to surround and select points in the current plot. Additional plotting tools are added just below Select. When '''Confidence Limits''' are available they can be adjusted using the controls near the bottom of the Plot Controls.
z.name  = name fields from all DataSet objects are concatenated.
z.type  = a.type;
z.author  = author fields from all DataSet objects are concatenated.
z.date  = date of concatenation
z.moddate  = date of concatenation
z.data  = [a.data b.data c.data ...];
z.label  = mode 2 label sets are concatenated, and new label sets are created for all other modes
z.axisscale  = mode 2 axisscale sets are made empty, and new axisscale sets are created for all other modes
z.title  = new label sets are created
z.class  = mode 2 class sets are made empty, and new class sets are created for all other modes
z.description  = concatenates all descriptions
z.userdata = if more than one input has userdata it is filled into a cell array, if only one input has userdata it is returned, else it is empty
===See Also===
[[dataset]], [[datasetdemo]], [[dataset/cat]], [[dataset/vertcat]]

Revision as of 16:07, 8 October 2008

Purpose

Horizontal concatenation of DataSet objects.

Synopsis

z = [a, b, c, ... ];

Description

[a b] is the horizontal concatenation of DataSet objects a and b. Any number of DataSet objects can be concatenated within the brackets. For this operation to be defined the following must be true: 1) All inputs must be valid DataSet objects or convertible to a DataSet object. 2) The DataSet '.type' fields must all be the same. 3) Concatenation is along the second dimension. The first and, for multiway, remaining dimension sizes must match. This is similar to matrix concatenation, but each field is treated differently. In structure notation this is:

z.name  = name fields from all DataSet objects are concatenated.
z.type  = a.type;
z.author  = author fields from all DataSet objects are concatenated.
z.date  = date of concatenation
z.moddate  = date of concatenation
z.data  = [a.data b.data c.data ...];
z.label  = mode 2 label sets are concatenated, and new label sets are created for all other modes
z.axisscale  = mode 2 axisscale sets are made empty, and new axisscale sets are created for all other modes
z.title  = new label sets are created
z.class  = mode 2 class sets are made empty, and new class sets are created for all other modes
z.description  = concatenates all descriptions
z.userdata = if more than one input has userdata it is filled into a cell array, if only one input has userdata it is returned, else it is empty

See Also

dataset, datasetdemo, dataset/cat, dataset/vertcat