Purity: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Scott
imported>Scott
 
(6 intermediate revisions by 4 users not shown)
Line 9: Line 9:
:[purint,purspec] = purity(data,ncomp,model);
:[purint,purspec] = purity(data,ncomp,model);
:[model]          = purity(data,model);
:[model]          = purity(data,model);
:purity  % Launches an Analysis window with purity as the selected method.


===Description===
===Description===


PURITY calculates pure variables and resolves data into ncomp spectra of the pure components (purspec) and their contributions (purint). For more information about the algorithm see PURITYENGINE. Data can be a matrix with the data or a dataset object.
PURITY calculates pure variables and resolves data into ncomp spectra of the pure components <tt>purspec</tt> and their contributions <tt>purint</tt>. For more information about the algorithm see PURITYENGINE. Data can be a matrix with the data or a dataset object.


The output arguments purity_values contains the purity values for all the variables and can be plotted as the "purity spectrum". The argument length_values contains the purity_values multiplied by the length of the variables. This results in a "length spectrum" that is easier to relate to the original data than the purity spectrum
The output arguments purity_values contains the purity values for all the variables and can be plotted as the "purity spectrum". The argument length_values contains the purity_values multiplied by the length of the variables. This results in a "length spectrum" that is easier to relate to the original data than the purity spectrum.
 
NOTE: Wavelength values must be in the first "set" of the axisscale.


===Options===
===Options===
Line 26: Line 29:
* '''axistype''': {2x1} [char]
* '''axistype''': {2x1} [char]


:'''Mode''' 1: [{continuous}|'discrete'|'bar']
:'''Mode 1''': [{continuous}|'discrete'|'bar']


:'''Mode''' 2: [{continuous}|'discrete'|'bar'] defines plots. If emtpy the values of the (future) DSO field will be used in case they are not defined, the 'continuous' defaults will be used.
:'''Mode 2''': [{continuous}|'discrete'|'bar'] defines plots. If emtpy the values of the (future) DSO field will be used in case they are not defined, the 'continuous' defaults will be used.


* '''select''': [{[]},[1 2]]  if empty, pure rows/columns will be selected from last slab, otherwise, the numbers identify from which slab(s) the pure rows/columns are selected.
* '''select''': [{[]},[1 2]]  if empty, pure rows/columns will be selected from last slab, otherwise, the numbers identify from which slab(s) the pure rows/columns are selected.
Line 40: Line 43:
* '''algorithm''': 'purityengine' defines algorithm used.
* '''algorithm''': 'purityengine' defines algorithm used.


* '''interactive''': ['on',{'off'}, defines interactivity; 'on', 'cursor','inactivate','reactivate']         'reactivate', 'cursor', 'inactivate', 'reactivate' are used for higher level calls for interactivity,'off' is used for demos and command mode applications.   
* '''interactive''': ['on',{'off'}, defines interactivity; 'on', 'cursor','inactivate','reactivate'] 'reactivate', 'cursor', 'inactivate', 'reactivate' are used for higher level calls for interactivity,'off' is used for demos and command mode applications.   


* '''resolve''': ['off'|{'on'}] indicates if the resolved results are required or not.
* '''resolve''': ['off'|{'on'}] indicates if the resolved results are required or not.
Line 48: Line 51:
Resolving 4 components in a data set:
Resolving 4 components in a data set:


:[purint,purspec]=purity(data,4)
<pre>[purint,purspec]=purity(data,4)</pre>


===Algorithm===
===Algorithm===


The core algorithm is the function purityengine.
The core algorithm is the function <tt>purityengine</tt>.


===See Also===
===See Also===


[[purityengine]]
[[analysis]], [[purityengine]]

Latest revision as of 09:33, 6 March 2018

Purpose

Calculation of pure variables.

Synopsis

[purint,purspec] = purity(data,ncomp,options);
[model] = purity(data,ncomp);
[purint,purspec] = purity(data,ncomp,model);
[model] = purity(data,model);
purity  % Launches an Analysis window with purity as the selected method.

Description

PURITY calculates pure variables and resolves data into ncomp spectra of the pure components purspec and their contributions purint. For more information about the algorithm see PURITYENGINE. Data can be a matrix with the data or a dataset object.

The output arguments purity_values contains the purity values for all the variables and can be plotted as the "purity spectrum". The argument length_values contains the purity_values multiplied by the length of the variables. This results in a "length spectrum" that is easier to relate to the original data than the purity spectrum.

NOTE: Wavelength values must be in the first "set" of the axisscale.

Options

options = a structure array with the following fields:

  • display: ['off'|{'on'}] display to command window.
  • plot: ['off'|{'on'}] plotting of result.
  • axistype: {2x1} [char]
Mode 1: [{continuous}|'discrete'|'bar']
Mode 2: [{continuous}|'discrete'|'bar'] defines plots. If emtpy the values of the (future) DSO field will be used in case they are not defined, the 'continuous' defaults will be used.
  • select: [{[]},[1 2]] if empty, pure rows/columns will be selected from last slab, otherwise, the numbers identify from which slab(s) the pure rows/columns are selected.
  • offset: [3 10] default noise correction factor for the two slabs.
  • offset_row2col: 3 scalar value row2col offset, default is offset(1).
  • mode: ['rows',{'cols'},'row2col'] determines if pure rows, cols are selected. row2col 2 is row-to-column solution.
  • algorithm: 'purityengine' defines algorithm used.
  • interactive: ['on',{'off'}, defines interactivity; 'on', 'cursor','inactivate','reactivate'] 'reactivate', 'cursor', 'inactivate', 'reactivate' are used for higher level calls for interactivity,'off' is used for demos and command mode applications.
  • resolve: ['off'|{'on'}] indicates if the resolved results are required or not.

Examples

Resolving 4 components in a data set:

[purint,purspec]=purity(data,4)

Algorithm

The core algorithm is the function purityengine.

See Also

analysis, purityengine