PeakLab v1 Documentation Contents AIST Software Home AIST Software Support
This is PeakLab's transform preprocessing option, used to alter the data using user-entered calculations. This option is only available from the topmost data level. This procedure is accessed via the Transform Data button in the main data window or the Transform Data item in the main Data menu.
You can also use the Transform Data icon in the main program toolbar.
For transforming just one data set when many are present, from the main window right click the data set of interest and select Apply Transform to this Data Set from the popup menu.
A transform consists of mathematical equations used to transform one or more of the variables within the data sets. In a transform, the X or Y data table values are treated as vectors and simply referenced as X or Y.
Common X Transforms
Seconds to Minutes
Select this option to automatically enter the X=X/60 transform to convert the X-scale from seconds to minutes.
Minutes to Seconds
Select this option to automatically enter the X=X*60 transform to convert the X-scale from minutes to seconds.
Dead-Time Adjustment for Thermodynamic Capacity Factor
Select this option to automatically enter the X=X/dt-1 transform to convert the X-scale to retention units, where dt is the column dead time value. You must enter the Column Dead Time value in this field for this transform to appear. This dead-time value is saved across sessions.
Common Y Transforms
Normalize for Unit Area, Xmin to Xmax
Select this option to automatically enter the Y=Y/AREA transform to convert the Y-data to unit area. The AREA data table constant will contain the discrete area for each data set that is being transformed.
Zero All Negative Y values
Select this option to automatically enter the Y=IF(Y<0,0,Y) transform to zero all negative Y-data values.
First Order Difference, dY
Select this option to automatically enter the Y=Y-YLAG(1) transform to difference the Y data.
First Order Derivative By Difference, dY/dX
Select this option to automatically enter the Y=IF((X-XLAG(1))>0,(Y-YLAG(1))/(X-XLAG(1)),0) transform to generate first derivative data.
Cumulative of Y Values
Select this option to automatically enter the Y=YCUMULATIVE transform to generate the discrete cumulative of the data. The YCUMULATIVE is a function with no parameters that processes the current implied X-data value and generates a cumulative.
Change Sign of Y values
Select this option to automatically enter the Y=-Y transform to change the sign of the data. You will need to use this option if the raw data consists of inverted peaks.
X and Y Custom Transforms
PeakLab's full parser for user-defined peaks is available for custom transforms. You can use any supported function which is available at the time of the transform. For example, the data constants will have been evaluated, but nothing of specific peak properties. You can thus enter a transform such as Y=Y+GNoise(1) to add 1% random Gaussian noise to a data set in order to see how well a model holds up when this level of white noise is present in the signal.
This is also one of many ways to generate pure test data. For example, the Y=GenHVL(x,1,3,.25,.05,.1) will generate a generalized HVL peak of the given parameters using the X-values in the current data set.
Only one expression, X= or Y=, need be used in the overall transform. These X= and Y= prefixes are automatically supplied. If you enter both X and Y transforms and there are cross references to X and Y in the X= and Y= expressions, bear in mind that the X= transform will be applied first, in full, and only then will the Y= expression be applied.
The weights calculation is not presently used.
Parser Function Help
There are two dropdowns. The first lists the class of function, and the second lists the specific function in that class. The default All Constants, Variables, and Functions lists everything in the parser. The Insert Button will automatically place the function, with any parameter list, in the Y field.
Copy, Cut, Paste
Use these buttons to move expressions to and from the clipboard, or to modify the text across the various fields.
Transforms that have been saved to disk are imported by using the Read button. It is a good idea to save a transform that will likely be used on future data sets. Transform files have [CLC] extensions. These should be created only within the program.
You must explicitly save a calculation to disk using the Save button in order to have it available in a future session.
The calculation will be validated when you exit the Transform Data entry screen. If there is an error in any of the expressions, an error message will report a specific parser or math error and you will be shown where within the expression the evaluation failed. The cursor will also be placed at this position. Note that a transform must be defined at the Xmean and/or Ymean of the data table. Transforms are compiled for a very rapid processing with large data sets.
Option to Apply
When you click OK, you will be presented with a PeakLab Graph of the transformed data. Click Accept to create a new data level in the program containing the transformed data. Click Cancel if you wish to exit the transform procedure without altering the state of the data.
Multiple Data Sets
If you have multiple data sets present, all will be shown in the graphical confirmation step, and the transform will apply to each, irrespective of whether or not a data set is selected. The data set selection in the main screen applies only to the View and Compare Data options and the Local Maxima Peaks, Hidden Peaks - Residuals, and the Hidden Peaks - Second Derivative fitting options.
When the Accept is selected, all of the data sets will be preprocessed with the transform(s) specified.
To graphically evaluate a transform more closely, you may double click that graph or right click and select the Plot This Data Set option from the popup menu. When you then click OK, double click this single graph, or right click and select Plot All Data Sets from the popup menu, all of the transformed data sets will again be shown.
Transforming only a Single Data Set
In order to transform an individual data set, do not invoke this Transform Data option from the main menu or the main window's dialog button. Instead, from the main window, and from the topmost data level, right click the data set of interest and select Apply Transform to this Data Set from the popup menu. After performing a local transform, a warning will be given that the pre-transformed data will be overwritten (no new data level is created). If you import five data sets, for example, and one of these was run with seconds units instead of minutes, you should use this individual transform option to convert this disparate data set to the same scale as the others.