Experimentreadr and Peaksigmoid: 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:
===Purpose===
===Purpose===
Outputs a sigmoid function.


Read an Experiment File containing filenames and reference measurement data, and imports the corresponding files and data into Analysis GUI. Makes it possible to automatically assign the data to x and y and to calibration and validation blocks.


===Synopsis===
===Synopsis===


:experimentreadr(''filename'')
:[y,y1,y2] = peaksigmoid(x,ax)


===Description===


Experiment files include a list of data files and their corresponding
===Inputs===
"properties of interest" (y-values). An experiment file is expected to be
a plain text file (comma, space, tab or other delimited file) or a Microsoft
Excel-formatted file. The file must consist of one column of text strings indicating the files to be
read and used as samples in the X-block of a regression or classification
model and at least one column of numerical values indicating the values to use as
the corresponding y-block. If no experiment file filename is specified on
the command line, the user is prompted to locate a suitable file.


Once loaded, the experiment file can be manipulated, excluding samples
* '''x''' =  3 element vector where
using the include field of the Row Labels tab, or y-block columns using
:* x(1) = coefficient
the include field of the Column Labels tab. Samples can be marked as in
:* x(2) = offset
the Calibration or Validation set using the Row Labels tab.
:* x(3) = decay constant


When all manipulations are complete, the user clicks the check-mark
===Outputs===
toolbar button to import all the indicated files and automatically load
the experiment data into the Analysis GUI.


====X-block File Formats====
The x-block files named can be in any standard readable
file format. However, experiment files do not currently allow for any
multi-file formats. Named files must contain only one sample (row) of
data per file.


====Header Row====
An experiment file can include an optional header row for the
filenames and properties of interest. This row can contain text lables
which will be used to label the y-block columns (i.e. giving a text
description of the property of interest.)


====Calibration/Validation====
Experiment files can also contain information
used to split the data into calibration and validation sets. To use this
feature, include an additional column with the keywords "Calibration" or
"Validation" next to each file. When the experiment is imported, the data
will be automatically loaded into the appropriate data blocks.
NOTE: other valid synonyms include (all are case insensitive)
:Calibration = Cal = C   
:Validation  = Val = V = Test = T


====Overriding File Format====
<math>\sqrt{1-e^2}</math>
If the extension on the specified files does not unambiguously identify the importer to be used (e.g. xy files with an
extension of ".txt" will be read by the delimited text file importer, not the XY importer), then the file may supply an additional "header" line above the column headers which specifies the file format to expect. This line must contain the keyword "format" followed by an equal sign and the name of the import method to use. For example:
  format=xy
Note that an overriding file format can ONLY be specified when a column header row (described below) is also included.


===Example Experiment File===
<math>f\left( {{a}_{i}},\mathbf{x} \right)={{x}_{1}}\left[ {{x}_{4}}{{\operatorname{e}}^{\frac{-4\ln \left( 2 \right){{\left( {{a}_{i}}-{{x}_{2}} \right)}^{2}}}{x_{3}^{2}}}}+\left( 1-{{x}_{4}} \right)\left[ \frac{x_{3}^{2}}{{{\left( {{a}_{i}}-{{x}_{2}} \right)}^{2}}+x_{3}^{2}} \right] \right]</math>
<tt>
  filename,concentration,cal/val
  file1.spc,13.2,cal
  file2.spc,19.0,cal
  file3.spc,5.3,cal
  file4.spc,8.3,val
</tt>


The above experiment file would define an experiment with three samples with X-block data
stored in the indicated files and y-values of 13.2, 19.0, 5.3, and 8.3
(with a text description of the y-values as "concentration"). The first
three files would be used for calibration, the last file for validation.


[[Image:Experimentreadr diagram.png||600px| ]]
<math>f\left( {{a}_{i}},\mathbf{x} \right)={{x}_{1}}\left[ {{x}_{4}}{{\operatorname{e}}^{\frac{-4\ln \left( 2 \right){{\left( {{a}_{i}}-{{x}_{2}} \right)}^{2}}}{x_{3}^{2}}}}+\left( 1-{{x}_{4}} \right)\left[ \frac{1-x_{3}^{2}}{{{\left( {1}+{{x}_{2}} \right)}^{2}}+x_{3}^{2}} \right] \right]</math>


===See Also===


[[analysis]], [[autoimport]], [[xclreadr]]
 
<math>f\left( {{a}_{i}},\mathbf{x} \right)={{x}_{1}}\left[ {}+\left( 1-{{x}_{4}} \right)\left[ \frac{1-x_{3}^{2}}{{{\left( \right)}+x_{3}^{2}} \right] \right]</math>
 
* '''y(1) ''' =
 
* '''y(2)  '''  = <math>{\operatorname{d}\!y\over\operatorname{d}\!{x}_{i}}</math>
 
* ''' y(3)  '''  = <math>{\operatorname{d^2}\!y\over\operatorname{d}\!{{x}_{i}}^{2}}</math>

Revision as of 11:37, 4 August 2016

Purpose

Outputs a sigmoid function.


Synopsis

[y,y1,y2] = peaksigmoid(x,ax)


Inputs

  • x = 3 element vector where
  • x(1) = coefficient
  • x(2) = offset
  • x(3) = decay constant

Outputs



Failed to parse (syntax error): {\displaystyle f\left( {{a}_{i}},\mathbf{x} \right)={{x}_{1}}\left[ {}+\left( 1-{{x}_{4}} \right)\left[ \frac{1-x_{3}^{2}}{{{\left( \right)}+x_{3}^{2}} \right] \right]}

  • y(1) =
  • y(2) =
  • y(3) =