3.7.5.42 NLSFNLSFobj
LabTalk Object Type:
 External Object
The NLSF object performs nonlinear least squares fitting. Curve fitting from script can be controlled through the this object's methods and properties.
Properties:
Property

Access

Description

nlsf.cn

Read only numeric

This is a vector value that stores values of the confidence interval for each parameter (Confidence Interval = Parameter Error * Chisquare Value). All the elements of this vector are shown in the ConfInter column of the Parameter worksheet.

nlsf.chiSqr

Read only numeric

Read the reduced chisquare value. This value is computed during iterations.

nlsf.chiSqrErr

Read/write numeric

Set the status of the Scale Errors with sqrt(reduced chisquare) check box on the Control Parameters dialog box. 0 = clear the check box. 1 = select the check box. For more information on this check box, see the Origin Help file.

nlsf.cod

Read only numeric

Read the coefficient of determination (r^2 value). The COD value is computed at the end of a round of fitting iterations. For the mathematical definitions of COD, see the Origin Help file.

nslf.compile

Read/write numeric

Report/control the state of the Compile Before Use check box located on the New Function / Edit Function tab of the NLSF: 0 = unchecked (do not compile), 1 = checked (compile) The current function is set from nlsf.func$.

nlsf.conf

Read/write numeric

Set the confidence level value. For more information, see the Origin Help file.

nlsf.confCol$

Read/write string

Same as nlsf.lconfcol$.

nlsf.constr$

Read/write string

Set constraints to the fitting process. If the property is not set, the fitting module defaults to no constraints. If constraints are changed, use this property to set them again.
To clear the constraint, use an empty string, i.e., nlsf.constr$ = " ";. Because Origin always stores the constraints internally, this command may be necessary to clean up the memory

nlsf.constraints

Read/write numeric

Enable/disable the general linear constraints set by the nlsf.constr$ object property.
0 = disable constraints.
1 = enable constraints.

nlsf.cor

Read only numeric

Read the correlation coefficient which is computed at the end of a round of iterations.

nlsf.covar$

Read/write string

Set a matrix that is used to store the variancecovariance matrix.

nlsf.curRow

Read/write numeric

The current row number. Access this number in the function scripts. Note: versions prior to 3.0 store this value into the system variable i.

nlsf.dataBegin

Read/write numeric

Set the beginning of the data range. The actual fitting is performed only on the data within this range. The default value is 1. However, when fitting from the menu, the fitting module automatically searches for the data range if it was set manually, or defaults to the entire column. For more information, see the Origin Help file.

nlsf.dataEnd

Read/write numeric

Set the end of the data range. This value must be set if you fit from scripts, as its default value is 0.

nlsf.dataStep

Read/write numeric

Set the data interval, which is defined as an incremental step size when only a subset of data points are used. This is a very useful feature when there are a large number of data points and you need a rough guess of the fit. 1 = every data point is used, 2 = every other data point is used, etc. When using script for fitting, this value is defaulted to 1. When you fit from the menu, this value is calculated so that only a limited number of data points are used. However, you may reset its value.

nlsf.derivStep

Read/write numeric

Set the parameter change amount ( ) for calculating numeric derivatives. A smaller value gives higher precision but may cause numeric roundoff errors. The default value is 0.005.

nlsf.dn

Read only numeric

Read the dependency of the nth parameter.

nlsf.dof

Read only numeric

Read the degree of freedom of the data and fitting function. For more information, see the Origin Help file.

nlsf.en

Read only numeric

Read the standard error values of the nth parameter.

nlsf.err

Read only numeric

Read the error code (or error message number). For more information, see the Origin Help file.

nlsf.fitColNum

Read only numeric

Number of columns used for fitting.

nlsf.fitDatan$

Read/write string

Read or set the full name(s) of the dependent variable(s). Note: You must assign the function to nlsf.func$ before you can assign the datasets to this property.

nlsf.fitWksName$

Read only string

Read the name of the worksheet that contains the fitting datasets (columns).

nlsf.fType

Read only numeric.

Read the internal ID of the function that is selected for fitting.

nlsf.func$

Read/write string

Set the specified function as the fitting function. For example, nlsf.func$ = "gauss"; sets the Gaussian function as the fitting function. Note: You must specify the function with this property before assigning nlsf.fitData$.

nlsf.funcCol$

Read/write string

Set a column to store functional values (upon completion of the fitting session). This property can be used in conjunction with nlsf.xmode, nlsf.xpoints, nlsf.databegin, nlsf.dataend and nlsf.makecurve( ).

nlsf.funcx$

Read/write string

Set a column as the X column to create datasets. These columns are used as the independent variables when creating the end results of a fitting session. This includes the fit curve, dataset and confidence and prediction bands. Refer to: nlsf.xmode and nlsf.makecurve().

nlsf.isBadData

Read only numeric

Check the data: 1 = enable, 0 = disable.

nlsf.isBadFunc

Read only numeric

Check the function selected for fitting: 1 = enable, 0 = disable.

nlsf.isDialogOpen

Read/write numeric

Read/set the internal ID of the opened dialog box.

nlsf.keepParam

Read/write numeric

Show if the parameters should be saved after closing the fitting session and restored before opening: 1 = enable, 0 = disable.

nlsf.lbn

Read/write numeric

This is a vector value. For each parameter, it reads/sets the lower bound value. These are the values that are displayed in the edit boxes in the Parameter Constraints dialog box.

nlsf.lbonn

Read/write numeric

Enable/disable use of nlsf.lbn
0 = disable.
1 = enable.

nlsf.lbxn

Read/write numeric

This is a vector value. It reads/sets the sign of each low constraint. Value 0 corresponds to <=, value 2 corresponds to <, ... These correspond to the button values displayed in the Parameter Constraints dialog box.

nlsf.lConfCol$

Read/write string

Set a column that is used to store the values of the lower confidence band.

nlsf.ln

Read only numeric

Read the lower confidence limit value of the nth parameter for a given confidence value (nlsf.conf).

nlsf.lPredCol$

Read/write string

Set a column that is used to store the values of the lower prediction band.

nslf.maxIter

Read/write numeric

Set the maximum number of iterations that will be performed.

nlsf.maxDerivStep

Read/write numeric

The execution of fitting requires a calculation of derivatives of a selected function. If the function is userdefined, the derivative is calculated numerically (see the Origin Help file). In this case, the maximum value of the step for the numeric derivative must be set for a "flexible (nonfixed) step" regime. So nlsf.maxderivstep contains just this value. For user defined functions, this value is read and set in the Derivative Delta group of the Control Parameters dialog box.

nlsf.minDerivStep

Read/write numeric

See nlsf.maxderivstep. This property is for the minimum value of the step.

nlsf.msgPrompt

Read/write numeric

Set to suppress message prompts: 1 = show all message prompts, 0 = suppress all message prompts, 2 = suppress parameter mutual dependency messages.

nlsf.mu

Read/write numeric

Set the value for diagonal magnification of the curvature matrix. This value is very important in the LevenbergMarquardt routine. Its default value is 0.001.

nlsf.muMin

Read only numeric

Read the smallest MU value ever reached.

nlsf.n$

Read only string

This is a vector of strings. It contains the names of all the parameters.

nlsf.names$

Read only string

Same as nlsf.n$.

nlsf.nConstr

Read only numeric

Read the number of constraints. The linear constraints are parsed and translated into a matrixvector format internally with the nlsf.nconstr as the number of linear equations.

nlsf.nConstrEff

Read only numeric

Read the number of effective constraints. If some parameters are fixed, the fitter disables them in the constraint equations by moving them from the left side of the equations to the right side. This may reduce the total number of equations. As a result, the final number of linear constraint equations may be less and is denoted as nlsf.nconstreff.

nlsf.nIter

Read only numeric

Read the number of iterations that are actually performed. Use nslf.maxIter to set the maximum number of iterations.

nlsf.noFitCurve

N/A

Not currently implemented. Read/set if the curve should be constructed. See nlsf.end( ) or nlsf.makecurve( ).

nlsf.nParaVary

Read only numeric

Read the number of parameters that are allowed to vary. Use nlsf.vn or PVn to set the nth parameter to fixed or vary.

nlsf.nPoints

Read only numeric

Read the number of data points that are actually used in the fitting. This value is the actual value used to calculate the degree of freedom (nlsf.dof) and the reduced chisquare value. Because there may be bad data points or functional evaluations, this value may be less than the userspecified value.

nlsf.numFitSets

Read/write numeric

Read/set the total number of sets. This property should be used when fitting multiple datasets. It should be set prior to assigning the independent and dependent variables. To set variables see: nlsf.indep$, nlsf.dep$ nlsf.setDepend() nlsf.setIndep(), nlsf.y$, nlsf.fitData$ and nlsf.x$.

nlsf.numIndep

Read only numeric

Read the total number of independent variables.

nlsf.numReplica

Read/write numeric

Read/set the number of replicas. This value should be set to the number of peaks in your dataset minus 1. When fitting multiple peak datasets, this value is used for each dependent variable.

nlsf.pasteToPlot

Read/write numeric

Paste results into the graph after fitting: 1 = enable, 0 = disable. The results of using this property will not be evident until the fitting session is ended. See the method nlsf.end( )

nlsf.pn

Read/write numeric.

Set or read the nth parameter values. If you know the names of your parameters, you can also read/write them using the parameter name. For example:
When fitting with the Gauss function, you can read/set y0, xc, w, and A.
If replicas are enabled, increment each parameter name (i.e. xc1, w1, A1, ... , xcn, wn, An). Note that y0 is not incremented in this case since it is common to both peaks.
Multiple datasets are incremented after an underscore. For instance, a two dataset fit where each dataset contains two peaks would yield parameters:
xc1_1, w1_1, A1_1, xc2_1, w2_1, and A2_1 for the first dataset
and
xc1_2, w1_2, A1_2, xc2_2, w2_2, and A2_2 for the second dataset.


nlsf.pred

Read/write numeric

Set the prediction level value. For more information, see the Origin Help file.

nlsf.predCol$

Read/write string

Same as nlsf.lpredcol$.

nlsf.sn

Read/write numeric

Read or set parameters as shared, where n is the parameter number as it occurs in the Parameters Sharing list on the Select Dataset page.
1 = shared.
0 = not shared.

nlsf.singularCriterion

Read/write numeric

This property is applicable when the SVD (single value decomposition) method is used for the matrix inversion. The SVD method's algorithm supposes to "ignore" (exactly, turn to 0 value = 1/element) the elements of the diagonal matrix, if these elements are very small (less than nlsf.singularcriterion).
The nlsf.singularcriterion variable contains the value that should be used as a criterion of how small the element (its relative value) is. All elements smaller than nlsf.singularcriterion will be turned to 0 in the inverse matrix. By default, nlsf.singularcriterion is equal to 1e60.

nlsf.ssr

Read only numeric

Read the value of the sum of squares function SS(p).

nlsf.status

Read only numeric

0 after closing a fitting session. 1 after opening a fitting session and initializing.

nlsf.tolerance

Read/write numeric

Set the tolerance value to stop the iterations. The tolerance value is a stop criterion. The default value is 1E9. For more information, see the Origin Help file.

nlsf.ubn

Read/write numeric

Same as nlsf.lb, but for the upper bound.

nlsf.ubonn

Read/write numeric

Enable/disable use of nlsf.ubn
0 = disable.
1 = enable.

nlsf.ubx

Read/write numeric

Same as nlsf.lbx, but for the upper bound sign.

nlsf.uConfCol$

Read/write string

Set a column that is used to store the values of the upper confidence band.

nlsf.un

Read only numeric

Read the upper confidence limit value of the nth parameter for a given confidence value (nlsf.conf).

nlsf.uPredCol$

Read/write string

Set a column that is used to store the values of the upper prediction band.

nlsf.vn

Read/write numeric

Tells whether parameter n is fixed or allowed to vary during fitting: 1 = vary, 0 = fixed. (You can fix a parameter using linear constraints.)

nlsf.wn$

Read/write string

Set the weight column. Weights designate the contributions from individual data points. This designated column must exist before this operation can be performed. This property can be incremented using n in cases where multiple datasets are being fitted simultaneously. See also nlsf.setWeight( ).

nlsf.wType

Read/write numeric

Set weight type: 0 = no weight, 1 = instrumental, 2 = statistical, and 3 = a specified column for weighting. In general, the default value of nlsf.wtype is 0 and there is no weight. When error bars are plotted and the fitting is from the Fit menu, the weight is defaulted to instrumental type, using the error bars for weighting, with nlsf.wtype equal to 1. Otherwise, this value always defaults to no weight. For more information, see the Origin Help file.

nlsf.x$

Read/write string

Set the X column as the independent variable for the fitting function. You typically have an X column to plot a dataset or a function. This designated column must exist before this operation can be performed. When there is no X column, Origin uses the default worksheet X values. Set default X values using the Format:Set Worksheet X menu command. This menu command allows you to set a start value and incremental step size for Y column plotting (or fitting) when no X column exists. See also 1) nlsf.indep$ and nlsf.dep$, 2) nlsf.setDepend( ) and nlsf.setIndep( ), or 3) nlsf.y$ or nlsf.fitData$ (which is often paired with nlsf.x$).

nlsf.xBegin

Read/write numeric

Set a start value for the curves created using the command nlsf.makecurve( ). After a fit, you may want to create a dataset with the fitting function according to the parameters found from the fitting. Use this command with nlsf.xpoints, nlsf.xstep, or nlsf.xend to create a function dataset.

nlsf.xEnd

Read/write numeric

Same as nlsf.xbegin but set the end value.

nlsf.xMode

Read/write numeric

This value determines how to use the independent variable X when creating a function set or confidence and prediction intervals. Refer to the nlsf.makecurve() command for creating a dataset. There are several modes:
nlsf.xmode = 0: Create the dataset according to the X values of the original Y dataset (the dataset which is used for fitting). In this case the X values used are those in the dependent variable's associated X column (or the Worksheet X if no X column is present).
nlsf.xmode = 1: Create the dataset according to the given X starting value (nlsf.xbegin), the incremental step size (nlsf.xstep), and the total number of data points (nlsf.xpoints). In this case a specific dataset is not needed.
nlsf.xmode = 2: Create the dataset according to any given X column. With this mode, you need to have an X column and set it using the command nlsf.funcx$ = "xxx". The X column must exist in a worksheet somewhere in the project and contain data for this xmode to work.
nlsf.xmode = 4: Create the dataset according to the first and last X values of the fitting dataset. The X values of the dataset are uniformly chosen reflecting the Xaxis scale. There are nlsf.xpoints data points for this curve. With this mode, you must create an X column to store the X values. Assign this column using the command nlsf.funcx$ = "xxx". You also need to assign the number of data points using nlsf.xpoints. If you want a uniform curve on the graph with a nonlinear Xaxis scale, use this command.
nlsf.xmode = 5: Similar to mode 4, but create the dataset with X values starting at nlsf.xbegin and ending at nlsf.xend. Otherwise, see the previous description

nlsf.xPoints

Read/write numeric

Set the number of points for the fit curve dataset. Refer to nlsf.makecurve( ), nlsf.xbegin, and nlsf.xstep.

nlsf.xStep

Read/write numeric

Set the incremental step size for the independent variable X for the function dataset. Refer to nlnlsf.make( ), nlsf.xbegin, and nlsf.xpoints.

nlsf.yn$

Read/write string

Set the Y column as the dependent variable for the fitting function. This is the dataset to be fitted. You must have this column set before you can perform any fitting operations. If you fit from the menu, Origin automatically sets the current active plotted dataset as the Y column, and its corresponding X column as the dependent variable (if there is an X column). This designated column must exist before this operation can be performed. When fitting multiple datasets, increment the dataset using n. See also nlsf.fitData$, nlsf.setDepend(), nlsf.Dep$. See related nlsf.x$, nlsf.setIndep(), nlsf.indep$.

Methods:
Method

Description

nlsf.addfunc(category, path, arg)

Add a function to the function list in the NLSF. category = the category the function should appear under, path = the full path to the .fdf file, arg = whether to copy the function file to the functions folder ( /User Files/fitfunc/ subfolder); 0 = don't copy, 1 = copy, 2 = not ask.
Note that arg is a combination of these controlling bits which produces cumulative effects. For example, to overwrite/update a function in the functions folder, set arg = 3 (includes 1 = copy function, and 2 = not ask).

nlsf.begin( )

Start a fitting session. A fitting session is defined as the duration of time in which various mathematical operations can be performed, including the most important operation, the LevenbergMarquardt minimization or the simplex minimization. In a fitting session, all storage space including the covariance matrix persists in the entire duration.

nlsf.category(arg)

Set the function's category. Arg is the name of the category.
For example, nlsf.category(Exponential) sets the category to "Exponential" for the function's selection. Arg should have the exact spelling as the nlsf category

nlsf.control(arg)

( ) Open the NLSF dialog box at the current status. (close) Close the current dialog box.
(select) Open the Select Function dialog box.
(dataset) Open the Select Dataset dialog box. In order to open this dialog box, you must have selected a function.
(new) Open the Define New Function dialog box.
(edit) Open the Edit Function dialog box. In order to open this dialog box, you must have selected a function.
(fit) Open the Fitting Session dialog box. In order to open this dialog box, you must have selected a function and assigned fitting datasets.
(replicas) Open the Replicas dialog box. In order to open this dialog box, you must have selected a function which allows replicas, such as the Gauss function.
(simulate) Open the Simulate Curves dialog box. In order to open this dialog box, you must have selected a function.
(results) Open the Generate Results dialog box. In order to open this dialog box, you must have selected a function and assigned fitting datasets.
(init) Open the Initializations dialog box. In order to open this dialog box, you must have selected a function.
(after) Open the After Fitting dialog box. In order to open this dialog box, you must have selected a function.
(control) Open the Control Parameters dialog box. In order to open this dialog box, you must have selected a function.
(constraints) Open the Parameter Constraints dialog box. In order to open this dialog box, you must have selected a function.

nlsf.chkConstr( )

Check whether constraints are violated or not. This method helps you determine if the constraints are selfconsistent, which may be critical for smooth fitting.

nlsf.cleanUpFitData( )

Clean up all the internal objects. This method can be called at either the beginning or end of the fitting session. Its function is similar in both cases. At the beginning, nlsf.cleanupfitdata( ) can serve as a way to reset the fitting data sets if a fitting session was just performed (or you're not sure if one has) and you want to perform another one. At the end, the method serves as a way to clean up the internal data set assignments prior to ending a fitting session so that the next fit (if there is one) starts clean. Several properties remain set even after this method is executed. These include the fitting function and parameter values. This allows quicker fitting, especially from the NLSF GUI since one can reopen the NLSF after a fitting session has completed and reassign a new fit data set without having to reselect the fitting function and initialize the parameters..

nlsf.cmatrix(index1, index2)

Return the value of the element of the constraint's matrix with indexes (index1, index2). Example: nlsf.cmatrix(2, 1) = ; returns the value of the element that is located in the second column and first row.

nlsf.createCurves(curveType)

Plot the confidence and prediction bands. If curveType = C, create confidence bands. If curveType = P, create prediction bands. The confidence and predicition levels can be from nlsf.conf and nlsf.pred.

nlsf.end(n)

End a fitting session. n = 8: do not paste Fit Label to results log. n = 4: do not paste Fit Label to graph. n = 1: do not create a fit curve. The argument uses a bit oriented method. In this method n= 13 ( 8+4+1) will set all three options. If n is omitted then no options are set. After this method, related internal storage space is destroyed. You can start another fitting session using nlsf.begin( ).

nlsf.fit(n)

Similar to nlsf.iterate(n), except this method automatically generates a fitted curve with an X dataset. In the default case the curve is generated and the data is placed in the original worksheet next to the independent variable. These datasets are generated with nlsf.xPoints number of points and the X values are evenly spaced in the current X axis space. The FitFunc datasets are not generated again if they already exist. To open the worksheet for these datasets, use the script: edit fitfunc; .

nlsf.funcVal(x)

Get the function value for a given independent value x.

nlsf.init( )

Initialize the fitting DLL and put Origin in a status that is ready to start a fitting session. 50 parameters are allocated by default. All system variables are set to default values. This method is equivalent to selecting Action:Reset in the Advanced Fitter.

nlsf.iterate(n)

Iterate the fitting procedure for n iterations without creating a fit curve. This is the kernel of the fitting module, in the sense that the actual fitting routines which are the LevenbergMarquardt minimization and the corresponding constraint routines (if there are any constraints) are used to find the parameters. If the tolerance value (see the Origin Help file) is satisfied, the fitter stops before the specified number of iterations are finished. This operation can only be done within a fitting session. If n = 0, the fitter is not activated but the reduced chisquare value as well as the fit are recalculated based on current parameters.

nlsf.make( )

Same as nlsf.makecurve( ).

nlsf.makecurve(type)

Make datasets according to the specification type. The current implementation supports creating a fit curve dataset, confidence bands, prediction bands, and a variancecovariance matrix. The corresponding X values of these datasets are determined by nlsf.xmode. These operations succeed only after you have supplied proper column names for the generated datasets. (func) makes a function dataset according to the fitting function, the given parameters, nlsf.xmode, nlsf.xbegin, nlsf.xend, nlsf.xstep, and nlsf.xpoints.
nlsf.makecurve(conf) makes confidence bands according to the fitting function, the given parameters, nlsf.xmode, nlsf.xbegin, nlsf.xend, nlsf.xstep, and nlsf.xpoints. The default confidence value is 0.95, which can be changed using nlsf.conf. See also nlsf.createCurves(C ) (pred) makes prediction bands according to the fitting function, the given parameters, nlsf.xmode, nlsf.xbegin, nlsf.xend, nlsf.xstep, and nlsf.xpoints. The default confidence value is 0.95, which can be changed using nlsf.pred.
For nlsf.makecurve(func),' nlsf.makecurve'(conf), and nlsf.makecurve(pred), you must provide columns to store the resulting datasets and assign them using nlsf.funcCol$, nlsf.lPredCol$, and nlsf.uPredCol$. Depending on nlsf.xmode, you may need to provide a corresponding X column (see nlsf.xmode). (v) creates the variancecovariance matrix. Before you use this command, you must create a matrix and use nlsf.covar to set the matrix to store the variancecovariance matrix.

nlsf.pasteParams(ctrl)

Paste the parameters to the graph or Results Log. If ctrl = PLOT (or just ctrl = P), paste the parameters to the graph. If ctrl = RESULTS (or ctrl = R), paste the parameters to the Results Log.

nlsf.paraConf( )

Create the confidence intervals for individual parameters. View results using Pun for upper confidence limit of parameter n, and PLn for lower confidence limit. Use nlsf.conf = xxx; and nlsf.pred = xxx; to set the confidence and prediction levels before this command is executed. This operation can only be done within a fitting session.

nlsf.paraRange( )

Set parameters to a region that satisfies constraints if they exist. This method actually invokes constraint routines.

Nlsf.paramWks(arg)

Create the parameters worksheet. Specify the name of the worksheet to be created by entering a string (or string variable) for arg. This is equivalent to clicking the Param. Worksheet button in Action:Results or running the [ParaConf] section in Fit.OGS.

nlsf.parse( )

Parse constraints explicitly and set up related storage space for constraint operations. Constraints must be parsed before they can be used. The fitter checks for the constraints and calls this method internally if there are constraints and they are still not parsed.

nlsf.report(n)

Generates a report without ending the fitting session. n = 8: do not paste Fit Label to results log. n = 4: do not paste Fit Label to graph. n = 1: do not create a fit curve. The argument uses a bit oriented method. In this method n= 13 ( 8+4+1) will set all three options. If n is omitted then no options are set.

nlsf.residuals( )

Create a residuals plot for the dependent variable.

nlsf.rsConstr( )

Not currently implemented. This method restores the constraint's value saved after the last fitting session closing.

nlsf.setDepend(VarName, Dataset)

VarName is the variable name. Dataset is the full dataset name. This method sets Dataset as the variable varName. Therefore, it has the same effect as an assignment in the Select Dataset dialog box. For example: nlsf.setdepend(act,data1_activity)

nlsf.setIndep(VarName, Dataset)

Same as nlsf.setdepend( ) but for independent variables.

nlsf.setWeight(VarName, WVarName, Dataset)

VarName is the dependent variable name. WVarName is the name of the weight variable related to VarName. Dataset is the full dataset name of the column to use as a weight for VarName.

nlsf.simplex(n)

Iterate to find parameters using the simplex method, according to the specified n iterations. When parameter values are unknown at the beginning, the simplex method can be used to initialize them or to make a reasonable guess. The simplex method typically needs more functional evaluations to reach the minimum.

nlsf.svConstr( )

Not currently implemented. Save constraint values after closing a fitting session.

nlsf.unInit( )

Uninitialize the fitting module and free up all memory that was allocated during various fitting operations. This method is necessary after fitting operations which use a lot of memory due to a large number of parameters and constraints.

nlsf.updateDialog( )

Update the parameter values in the Fitting Session, Simulate, and Parameter Initialization dialog boxes. Used during a fitting session when new values for parameters are computed and need to be displayed in the dialog box.

nlsf.varCovar(index1, index2)

Used like nlsf.cmatrix( ), but for the variancecovariance matrix.

Examples:
This script fits the first plotted dataset in the active graph window using the exponential decay 2 fitting function.
nlsf.func$ = ExpDecay2;
nlsf.cleanupfitdata(); //begin fitting session
nlsf.fitdata$ = %(1,@D); //fit first dataset in layer
nlsf.tolerance = 0; //set tolerance
nlsf.W$ = errof(%(1,@D)); //use error bars as weight if exist
if (nlsf.w$ == "")
{
nlsf.wtype = 0;
};
else
{
nlsf.wtype = 1;
};
limit %C;
nlsf.xBegin = limit.xmin; //set up x values
nlsf.xEnd = limit.xmax;
nlsf.xPoints = 1000; //number of data points for fitted curve
nlsf.fit(20); //FIT, 20 iterations
This script performs an exponential decay 2 fit on worksheet data. This example assumes a worksheet named Exp is active with columns A, B and Fit.
nlsf.func$ = ExpDecay1;
A1 = 10; //initialize parameter values
t1 = 1;
x0 = 0;
y0 = 0;
nlsf.cleanupfitdata();
nlsf.fitdata$ = exp_b;
nlsf.iterate(20);
nlsf.xmode = 2;
nlsf.funcx$ = exp_A; //use as X dataset
nlsf.funccol$ = exp_Fit; //dataset to store fitted Y values
nlsf.makecurve(func); //dataset generated for the fitted curve
This script fits two datasets (called Draw1_b and Draw2_b) to the builtin Boltzmann fitting function. First, the fitting session is set up. Next, the initial parameters for Draw1_B are defined. Third, the initial parameters for Draw2_b are defined. Finally, the fitting session is performed.
To work through the next example, you must first create the data. You can do this by opening an empty graph window and using the Draw Data tool on your Tools toolbar.
Creating two drawn datasets in this manner in a new project will automatically prepare you for this example as the datasets are named Draw1_b and Draw2_b by default. After preparing the data, execute the following script (for example, in the Script window):
// Set up the fit //
nlsf.func$ = Boltzmann; // select Boltzmann fitting function
nlsf.numfitsets = 2; // indicate 2 datasets to be fitted
nlsf.fitdata1$ = Draw1_B; // define 1st dataset to be fitted
nlsf.fitdata2$ = Draw2_B; // define 2nd dataset to be fitted
// Initialize parameter set for draw1_b //
nlsf.p1 = 0.1; // A1 of first dataset
nlsf.p2 = 10; // A2 of first dataset
nlsf.p3 = 4; // x0 of first dataset
nlsf.p4 = 1; // dx of first dataset
// Initialize parameter set for draw2_b //
nlsf.p5 = 0.1; // A1_2 of 2nd dataset
nlsf.p6 = 10; // A2_2 of 2nd dataset
nlsf.p7 = 8; // x0_2 of 2nd dataset
nlsf.p8 = 1; // dx_2 of 2nd dataset
// Perform the fit //
nlsf.fit(100); // iterate 100 times
