Uses either the Levenberg-Marquardt algorithm or the trust-region dogleg algorithm to determine the set of parameters that best fit the set of input data points (X, Y) as expressed by a nonlinear function y = f(x,a), where a is the set of parameters. You must manually select the polymorphic instance to use.


icon

Inputs/Outputs

  • cfxdt.png data —

    data specifies static data that the user-defined function needs at run time.

  • csvrn.png f(x,a) —

    f(x,a) is a reference to the VI that implements the fitting model. a is the set of parameters LabVIEW calculates.

    Use the VI template located at labview\vi.lib\gmath\NumericalOptimization\LM model function and gradient.vit to create the VI from a template.

  • c1ddbl.png Y —

    Y specifies the array of dependent values. The number of input points must be greater than zero and greater than the number of initial parameters. The number of elements in Y must be equal to the number of elements in X.

  • c1ddbl.png X —

    X specifies the array of independent values. The number of input points must be greater than zero and greater than the number of initial parameters. The number of elements in X must be equal to the number of elements in Y.

  • c1ddbl.png Weight —

    Weight is the array of weights for the observations Y. If Weight is unwired, this VI sets all elements of Weight to 1.

    If Weight has fewer elements than Y, this VI pads the end of Weight with ones so that the length of Weight equals the length of Y. If Weight has more elements than Y, this VI ignores the extra elements at the end of Weight. If an element in Weight is less than 0, this VI uses the absolute value of the element.

  • c1ddbl.png initial parameters —

    initial parameters specifies the initial guess for a solution. The success of the nonlinear curve fit depends on how close the initial parameters are to the solution. Therefore, use any available resources to obtain good initial guess coefficients to the solution before you use this VI.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • cnclst.png termination —

    termination specifies the stopping conditions for the fitting process.

  • ci32.png max iteration —

    max iteration specifies the largest number of iterations of the fitting routine. If the number of iterations exceeds max iterations, the fitting process terminates.

  • cdbl.png tolerance —

    tolerance specifies the relative change in the weighted distance between Y and the current fit. If the relative change falls below tolerance, the fitting process terminates.

  • ccclst.png parameter bounds —

    parameter bounds is a cluster that contains the upper and lower numeric limits for the parameters being optimized.

  • c1ddbl.png parameter minimum —

    parameter minimum contains the lowest allowed value of the parameters being optimized. The array does not accept values of NaN.

    The size of this array must either equal the size of the initial parameters array or be 0.

  • c1ddbl.png parameter maximum —

    parameter maximum contains the highest allowed value of the parameters being optimized. The array does not accept values of NaN.

    The size of this array must either equal the size of the initial parameters array or be 0.

    For all i, parameter maximum[i] must be greater than or equal to parameter minimum[i]. If parameter maximum[i] equals parameter minimum[i], LabVIEW uses that constant value throughout the curve fitting.

  • cu16.png method —

    method specifies the fitting method.

    0Least Square (default)
    1Least Absolute Residual
    2Bisquare
  • ii32.png number of function calls —

    number of function calls returns the number of times LabVIEW called f(x,a) during the fitting process.

  • i1ddbl.png best nonlinear fit —

    best nonlinear fit returns the y-values of the fitted model that correspond to the independent values in X.

  • i1ddbl.png best fit parameters —

    best fit parameters returns the array of parameters that minimizes the weighted mean square error between the solution vector and the observed y-values.

  • i2ddbl.png covariance —

    covariance returns the matrix of covariances.

    Cjk is the covariance between a[j] and a[k]. c[jj] is the variance of a[j]. This VI generates the covariance, C, according to the following equation: C = (0.5D)^–1 where D is the Hessian of the function with respect to its parameters.

  • idbl.png residue —

    residue returns the weighted mean square error between the best nonlinear fit and Y.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.