Batch Fit

Batch Fit

Create Batch Page by selecting Batch radio button on Data Explorer(see figure below) and for a new control page select 'New FitPage' in the 'Fitting' menubar.




Figure 1: MenuBar

Load Data to Data Explorer if not loaded.
Select one or more data sets by checking the check boxes, and then make sure that "Fitting" is selected in the dropdown menu next to the "Send To" button. Once ready, click the 'Send To' button to set data to a BatchPage. If already an empty batch page exists, it will be set there. Otherwise it will create a new Batch Page. Set up the model and the parameter values as same as a single fitting (see single fit help). The use 'Fit' button to perform the fitting.
Unlike a single fit, the results of the fittings will not return to the BatchPage'. Instead, a Grid window will be provided once the fitting is completed. The Grid window is also accessible from the 'View' menu (see Figure 2).
Note that only one model is used for all the data. The initial parameter values given in the control page will be used all the data fittings. If one wants the FitEngine to use the initial values from the results of the previous data fitting (if any), choose the 'Chain Fitting' in the Fitting menubar, which will speed up the fitting especially when you have lots of, and similar, data sets.

Batch Window

Batch Window provides an easy way to view the fit results, i.e., plot data, fits, and residuals. Batch window will be automatically shown after a batch fit is finished.
Once closed, it can be opened anytime from the "View" menubar item (see Figure 2).





Figure 2: Edit Menu

Edit Grid

Once a batch fit is completed, all fitted and fixed model parameters are displayed to the current sheet of the batch window except the errors of the parameters. To view the errors, click on a given column then under Edit menubar item, and insert the desired parameter by selecting a menu item with the appropriated label. Empty column can be inserted in the same way. A column value can be customized by editing an existing empty column.
To Remove column from the grid, select it, choose edit menu, and click the 'remove' menu item. Any removed column should reinserted whenever needed.
All above options are also available when right clicking on a given column label (see Figure 3). Note: A column always needs to be selected in order to remove or insert a column in the grid.



Figure 3: Edit Menu

Save Grid

To save the current page on the batch window, select the 'File' menubar item (see Figure 4), then choose the 'Save as' menu item to save it as a .csv file.
Note: The grid doesn't save the data array, fits, and the array residuals. As a result, the 'View (fit) Results' functionality will be lost when reloading the saved file.
Warning! To ensure accuracy of saved fit results, It is recommended to save the current grid before modifying it .

Open Batch Results

Any csv file can be opened in the grid by selecting the 'Open' under the 'File' menu in the Grid Window (see Figure 4). All columns in the file will be displayed but insertion will not available. Insertion will be available only when at least one column will be removed from the grid.


Figure 4: MenuBar

Plot

To plot a column versus another, select one column at the time, click the 'Add' button next to the text control of X/Y -axis Selection Range to plot the value of this column on the X/Y axis. Alternatively, all available range can be selected by clicking the column letter (eg. B). Repeat the same procedure the next axis. Finally, click the 'Plot' button. When clicking on Add button, the grid will automatically fill the axis label, but different labels and units can be entered in the correct controls before clicking on the plot button.
X/Y -Axis Selection Range can be edited manually. These text controls allows the following types of expression:
operation can be +, -, *, /, or pow.

1) if the current axis label range is a function of 1 or more columns, write this type of expression:
constant1 * column_name1 [minimum row index : maximum row index] operator constant2 * column_name2 [minimum row index : maximum row index]
Example : radius[2 : 5]< b> - 3 * scale[2 : 5]

2) if only some values of a given column are need but the range between the first row and the last row used is not continuous,
write the following expression in the text control:
column_name1 [minimum row index1 : maximum row index1] , column_name1 [minimum row index2 : maximum row index2]
Example : radius [2 : 5] , radius [10 : 25]

Note: Both text controls ( X and Y -axis Selection Range) need to be filled with valid entries for plotting to work (see Figure 5).



Figure 5: Plotting

View Column/Cell(s)

Select 1 or more cells from the same column, click the 'View Results' button to display available curves.
For example, select the cells of the 'Chi2' column, then click the 'View Results' button. The plots generates will represent the residuals plots.
If you select any cells of the 'Data' column and click the 'View Results' button. It generates both data and fits in the graph (see Figure 6).
Alternatively, just click the column letter (eg. B) to choose all the available Data sets, then simply click the 'View Results' button to plot the data and fits.




Figure 6: View Results