| [ec538c7] | 1 | <html> |
|---|
| 2 | <head> |
|---|
| 3 | </head> |
|---|
| 4 | |
|---|
| 5 | |
|---|
| 6 | <body> |
|---|
| 7 | <h4> Batch Fit </h4> |
|---|
| 8 | |
|---|
| 9 | <ul> |
|---|
| [b3199ac3] | 10 | <li><a href="#fitpage">Batch Fit</a></li> |
|---|
| [ec538c7] | 11 | <li><a href="#batchwindow">Batch Window</a></li> |
|---|
| 12 | </ul> |
|---|
| 13 | |
|---|
| [b3199ac3] | 14 | <h5><font color="blue"><a name="fitpage">Batch Fit</a></font></h5> |
|---|
| [ec538c7] | 15 | <p> |
|---|
| 16 | Create <b>Batch Page </b> by selecting <b>Batch </b> radio button on |
|---|
| [b3199ac3] | 17 | Data Explorer<font color="blue"><a href="#batch_button">(see figure below)</a></font> |
|---|
| 18 | and for a new control page select 'New FitPage' in the 'Fitting' menubar.<br /> |
|---|
| 19 | </p> |
|---|
| [ec538c7] | 20 | <br /><img src="batch_button_area.bmp" /><br /><br /> |
|---|
| 21 | <a name="figure1"><u>Figure 1: MenuBar</u></a><br /> |
|---|
| [b3199ac3] | 22 | <br /> |
|---|
| 23 | Load Data to Data Explorer if not loaded. <br/> |
|---|
| 24 | Select one or more data sets by checking the check boxes, and then make sure |
|---|
| 25 | that "Fitting" is selected in the dropdown menu next to the "Send To" button. |
|---|
| 26 | 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. |
|---|
| 27 | Otherwise it will create a new Batch Page. |
|---|
| 28 | Set up the model and the parameter values as same as a single fitting <font color="blue"><a href="single_fit_help.html">(see single fit help)</a></font>. |
|---|
| 29 | The use 'Fit' button to perform the fitting. |
|---|
| 30 | <br />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. |
|---|
| 31 | The Grid window is also accessible from the 'View' menu <font color="blue"><a href="#figure2">(see Figure 2)</a></font>. |
|---|
| 32 | <br /> Note that only one model is used for all the data. |
|---|
| 33 | 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 |
|---|
| 34 | from the results of the previous data fitting (if any), choose the 'Chain Fitting' in the Fitting menubar, which will speed up the fitting |
|---|
| 35 | especially when you have lots of, and similar, data sets. |
|---|
| [ec538c7] | 36 | </p> |
|---|
| 37 | |
|---|
| 38 | <h5><font color="blue"><a name="batchwindow">Batch Window</a></font></h5> |
|---|
| 39 | <p> |
|---|
| [b3199ac3] | 40 | Batch Window provides an easy way to view the fit results, i.e., plot data, fits, and residuals. |
|---|
| [ec538c7] | 41 | Batch window will be automatically shown after a batch fit is finished. <br /> |
|---|
| 42 | Once closed, |
|---|
| 43 | it can be opened anytime from the "View" menubar item <font color="blue"><a href="#figure2">(see Figure 2)</a></font>.<br /> |
|---|
| [b3199ac3] | 44 | </p> |
|---|
| [ec538c7] | 45 | <br /><br /><img src="restore_batch_window.bmp" /><br /><br /> |
|---|
| 46 | <a name="#figure2"><u>Figure 2: Edit Menu</u></a><br /> |
|---|
| [b3199ac3] | 47 | <br /> |
|---|
| [ec538c7] | 48 | <ul> |
|---|
| 49 | <li> <a href="#edit_grid"> Edit Grid </a></li> |
|---|
| 50 | <li><a href="#save_grid"> Save Grid </a></li> |
|---|
| 51 | <li><a href="#load_batch"> Open Batch Results </a></li> |
|---|
| 52 | <li><a href="#plot"> Plot </a></li> |
|---|
| 53 | <li><a href="#view"> View Column/Cell(s) </a></li> |
|---|
| 54 | </ul> |
|---|
| [b3199ac3] | 55 | |
|---|
| [ec538c7] | 56 | |
|---|
| 57 | |
|---|
| 58 | <h5><font color="blue"><a name="edit_grid"> Edit Grid </a></font></h5> |
|---|
| 59 | <p> |
|---|
| [b3199ac3] | 60 | Once a batch fit is completed, all fitted and fixed model parameters are displayed to the current sheet of |
|---|
| 61 | the batch window except the errors of the parameters. To view the errors, |
|---|
| 62 | click on a given column then under <b> Edit </b> menubar item, and insert the desired parameter by selecting |
|---|
| [ec538c7] | 63 | a menu item with the appropriated label. Empty column can be inserted in the same way. |
|---|
| [b3199ac3] | 64 | A column value can be customized by editing an existing empty column.<br /> |
|---|
| 65 | To Remove column from the grid, select it, choose edit menu, and click the <b> 'remove' </b> menu item. |
|---|
| 66 | Any removed column should reinserted whenever needed.<br /> |
|---|
| [ec538c7] | 67 | All above options are also available when right clicking on a given column label |
|---|
| 68 | <font color="blue"><a href="#figure3">(see Figure 3)</a></font>. |
|---|
| [b3199ac3] | 69 | <b>Note:</b> A column always needs to be selected in order to remove or insert a column in the grid.<br /><br /> |
|---|
| [ec538c7] | 70 | |
|---|
| 71 | <img src="edit_menu.bmp" /><br /><br /> |
|---|
| 72 | <a name="figure3"><u>Figure 3: Edit Menu</u></a><br /> |
|---|
| 73 | </p> |
|---|
| 74 | |
|---|
| 75 | |
|---|
| 76 | <h5><font color="blue"><a name="save_grid"> Save Grid </a></font></h5> |
|---|
| 77 | <p> |
|---|
| [b3199ac3] | 78 | To save the current page on the batch window, select the <b> 'File' </b> menubar item |
|---|
| 79 | <font color="blue"><a href="#figure4">(see Figure 4)</a></font>, then choose the <b> 'Save as' </b> |
|---|
| [ec538c7] | 80 | menu item to save it as a .csv file. <br /> |
|---|
| [b3199ac3] | 81 | <b>Note: </b> The grid doesn't save the data array, fits, and the array residuals. As a result, the 'View (fit) Results' functionality |
|---|
| [ec538c7] | 82 | will be lost when reloading the saved file.<br /> |
|---|
| 83 | |
|---|
| 84 | <font color="red">Warning! To ensure accuracy of saved fit results, It is recommended to save the current grid |
|---|
| 85 | before modifying it . </font> |
|---|
| 86 | </p> |
|---|
| 87 | |
|---|
| 88 | |
|---|
| 89 | <h5><font color="blue"><a name="load_batch"> Open Batch Results </a></font></h5> |
|---|
| 90 | <p> |
|---|
| [b3199ac3] | 91 | Any <b> csv </b> file can be opened in the grid by selecting the <b> 'Open' </b> |
|---|
| 92 | under the <b> 'File' </b> menu in the Grid Window <font color="blue"><a href="#figure4">(see Figure 4)</a></font>. |
|---|
| [ec538c7] | 93 | All columns in the file will be displayed but insertion will not available. |
|---|
| 94 | Insertion will be available only when at least one column will be |
|---|
| 95 | removed from the grid. |
|---|
| 96 | |
|---|
| 97 | <br /><img src="file_menu.bmp" /><br /><br /> |
|---|
| 98 | <a name="figure4"><u>Figure 4: MenuBar</u></a><br /> |
|---|
| 99 | </p> |
|---|
| 100 | |
|---|
| 101 | |
|---|
| 102 | <h5><font color="blue"><a name="plot"> Plot </a></font></h5> |
|---|
| 103 | <p> |
|---|
| 104 | To <b> plot </b> a column versus another, |
|---|
| [b3199ac3] | 105 | select one column at the time, click the <b> 'Add' </b> button next to the text control |
|---|
| [ec538c7] | 106 | of X/Y -axis <b> Selection Range </b> |
|---|
| [b3199ac3] | 107 | 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). |
|---|
| 108 | Repeat the same procedure the next axis. Finally, click the <b> 'Plot' </b> button. |
|---|
| [ec538c7] | 109 | When clicking on <b> Add </b> button, the grid |
|---|
| 110 | will automatically fill the axis label, but different labels and units can be |
|---|
| 111 | entered in the correct controls before clicking |
|---|
| 112 | on the plot button.<br /> |
|---|
| 113 | <b>X/Y -Axis Selection Range </b> can be edited manually. These text controls |
|---|
| 114 | allows the following types of expression:<br /> |
|---|
| 115 | |
|---|
| 116 | operation can be <font color="#00CC33"><b>+</b></font>,<font color="#00CC33"> |
|---|
| 117 | <b> -</b></font>, <font color="#00CC33"><b>*</b></font>, |
|---|
| 118 | <font color="#00CC33"><b>/</b></font>, or <font color="#00CC33">pow</font>.<br /> <br /> |
|---|
| 119 | |
|---|
| 120 | 1) if the current axis label range is a function of 1 or more columns, |
|---|
| 121 | write this type of expression: <br /> |
|---|
| 122 | constant1 * <font color="#CC9933">column_name1</font> |
|---|
| 123 | <font color="blue">[minimum row index : maximum row index]</font> |
|---|
| 124 | <font color="#00CC33">operator</font> constant2 <font color="#00CC33"> |
|---|
| 125 | <b>*</b></font> <font color="#CC9933">column_name2</font> |
|---|
| 126 | <font color="blue">[minimum row index : maximum row index]</font> <br /> |
|---|
| 127 | Example : <font color="#CC9933">radius</font>[2 : 5]<font color="#00CC33"><big>< |
|---|
| 128 | b> -</b></big></font> 3 <font color="#00CC33"><b>*</b></font> |
|---|
| 129 | <font color="#CC9933">scale</font>[2 : 5] <br /><br /> |
|---|
| 130 | |
|---|
| [b3199ac3] | 131 | 2) if only some values of a given column are need but the range between |
|---|
| 132 | the first row and the last row used is not continuous,<br />write |
|---|
| [ec538c7] | 133 | the following expression in the text control: <br /> |
|---|
| 134 | <font color="#CC9933">column_name1</font> |
|---|
| 135 | <font color="blue">[minimum row index1 : maximum row index1]</font> |
|---|
| 136 | <font color="#00CC33"><big><b> , </b></big></font> |
|---|
| 137 | <font color="#CC9933">column_name1</font> |
|---|
| 138 | <font color="blue">[minimum row index2 : maximum row index2]</font> <br /> |
|---|
| 139 | Example : <font color="#CC9933">radius </font><font color="blue"> [2 : 5] </font> |
|---|
| 140 | <font color="#00CC33"><big><b> , </b></big></font><font color="#CC9933">radius </font> |
|---|
| 141 | <font color="blue">[10 : 25] </font><br /><br /> |
|---|
| 142 | |
|---|
| 143 | |
|---|
| [40ae505] | 144 | <b>Note: </b>Both text controls ( X and Y-axis Selection Ranges) need to be filled |
|---|
| 145 | with valid entries for plotting to work (the dY-bar is optional) |
|---|
| 146 | <font color="blue"><a href="#figure5">(see Figure 5)</a></font>. |
|---|
| [ec538c7] | 147 | |
|---|
| 148 | <br /><br /><img src="plot_button.bmp" /><br /><br /> |
|---|
| 149 | <a name="figure5"><u>Figure 5: Plotting</u></a><br /> |
|---|
| 150 | |
|---|
| 151 | </p> |
|---|
| 152 | |
|---|
| 153 | |
|---|
| 154 | <h5><font color="blue"><a name="view"> View Column/Cell(s) </a></font></h5> |
|---|
| 155 | <p> |
|---|
| [9e91546] | 156 | Select 1 or more cells from the same column, click the <b> 'View Fits' </b> |
|---|
| [b3199ac3] | 157 | button to display available curves. <br /> |
|---|
| 158 | |
|---|
| [40ae505] | 159 | For example, select the cells of the <b> 'Chi2' </b> column, then click the <b> 'View Fits' </b> |
|---|
| [b3199ac3] | 160 | button. The plots generates will represent the <b>residuals </b> plots. <br /> |
|---|
| 161 | |
|---|
| [ec538c7] | 162 | |
|---|
| [b3199ac3] | 163 | If you select any cells of the <b> 'Data' </b> column and click the |
|---|
| [40ae505] | 164 | <b> 'View Fits' </b> button. It generates both |
|---|
| [b3199ac3] | 165 | <b> data and fits</b> in the graph <font color="blue"><a href="#figure6">(see Figure 6)</a></font>. <br /> |
|---|
| [ec538c7] | 166 | |
|---|
| [b3199ac3] | 167 | <b>Alternatively, just click the column letter (eg. B) |
|---|
| [40ae505] | 168 | to choose all the available Data sets, then simply click the 'View Fits' button to plot the data and fits. |
|---|
| [b3199ac3] | 169 | </b> |
|---|
| 170 | <br /> |
|---|
| [ec538c7] | 171 | <br /><br /><img src="view_button.bmp" /><br /><br /> |
|---|
| [40ae505] | 172 | <a name="figure6"><u>Figure 6: View Fits</u></a><br /><br /> |
|---|
| [ec538c7] | 173 | </p> |
|---|
| 174 | |
|---|
| 175 | |
|---|
| 176 | </body> |
|---|
| 177 | </html> |
|---|
