2.4.17 nlbeginz(Pro)

Brief Information

Start a nonlinear curve fitting session for XYZ data

Additional Information

X-Function not designed for Auto GetN Dialog. This feature is for OriginPro only.

This feature is updated in 8.0 SR5. For more details, please refer to Release Notes.

Command Line Usage

nlbeginz iz:=3 func:=gauss2D;

X-Function Execution Options

Please refer to the page for additional option switches when accessing the x-function from script

Variables

Display
Name 		Variable
Name 		I/O
and
Type 		Default
Value 		Description
Input iz

Input

XYZRange

<active>
 Specify the data to be fitted.
Fitting Function Name func

Input

string

<unassigned>
 Specify the fitting function used to fit data.
nltree

Input/Output

TreeNode

nlt
 This is the tree with which you can customize the settings of the fitting such as parameter values, standard error. For more details, please refer to here.
Number of Replicas replica

Input

int

0
 Specify the number of replicas. Enter a non-zero value if you want to fit your data to a built-in peak function by replicating the function for each peak. Each of function may have different parameter values. Your data should display multiple peaks of the same general form (e.g. Gaussian2D). If the function you have selected does not support replicas, this is disabled.
Dialog Theme theme

Input

string

<optional>
 Specify a theme. The settings saved in it will be loaded to customize the fitting.
Notation of Parameters pnotation

Input

int

para
 Specify the notation of parameters in the output tree.

Option list:

  • para:ParaName
Use the parameter names as notation.
  • abbr:Abbreviation
Use the abbreviations of the parameters as notation.
  • both:Both
Use both names and abbreviations of the parameters as notation.
Parameter Initialization init

Input

int

init
 Specify the status of parameter initialization.

Option list:

  • auto:Auto
Origin automatically decides whether to enable parameter initialization according to the FDF file of the fitting function.
  • enable:Enable
Enable parameter initialization.
  • disable:Disable
Disable parameter initialization.
How to Initialize the NLFit Object option

Input

int

0
 Specify how to initialize the NLFit Object.

Option list:

  • init_all:Init All Parameters
    Initialize all parameters and then do the fitting with these parameters.
  • change_data:Only Change Data
    Keep the former settings and only change dataset, then do the fitting to the new dataset.

Description

Start a nonlinear surface fitting session from XYZ data. You can also customize the fitting settings with it.

Examples

//Prepare the data
string fname$=system.path.program$ + "Samples\Matrix Conversion and Gridding\XYZ Random Gaussian.dat";  
newbook;
impasc; // import the data
nlbeginz 3 Gauss2D tt; // fit the XYZ data with 2D Gaussian function
nlfit;
nlend 1 2; // Show the fitted parameters in a dialog.

Related X-Functions

nlfit, nlend, nlgui, nlpara, nlfn, nlbegin, nlbeginr, nlbeginm

Keywords:regression, NLFit