Deprecated
As of 3.1 (to be removed in 4.0).
optimize and assumes that the rows of that matrix iterate on the model
functions while the columns iterate on the parameters; thus, the numbers
of rows is equal to the dimension of the
Target while
the number of columns is equal to the dimension of the
InitialGuess.
| Modifier and Type | Field and Description |
|---|---|
| protected int | cols
Deprecated
As of 3.1.
Number of columns of the jacobian matrix.
|
| protected double | cost
Deprecated
As of 3.1. Field to become "private" in 4.0.
Please use Cost value (square root of the sum of the residuals).
setCost(double).
|
| private static final double | DEFAULT_SINGULARITY_THRESHOLD
Deprecated
As of 3.1.
Singularity threshold (cf. getCovariances(double)).
|
| private int | jacobianEvaluations
Number of evaluations of the Jacobian. |
| private MultivariateDifferentiableVectorFunction | jF
Objective function derivatives. |
| protected double[] | objective
Deprecated
As of 3.1.
Current objective function value.
|
| protected double[] | point
Deprecated
As of 3.1.
Current point.
|
| protected int | rows
Deprecated
As of 3.1.
Number of rows of the jacobian matrix.
|
| protected double[][] | weightedResidualJacobian
Deprecated
As of 3.1.
Jacobian matrix of the weighted residuals.
|
| protected double[] | weightedResiduals
Deprecated
As of 3.1.
Weighted residuals
|
| private RealMatrix | weightMatrixSqrt
Square-root of the weight matrix. |
| Access | Constructor and Description |
|---|---|
| protected | |
| protected | AbstractLeastSquaresOptimizer(ConvergenceChecker<PointVectorValuePair>
Convergence checker. checker)
Deprecated
as a consequence of
ConvergenceChecker being deprecated.
|
| Modifier and Type | Method and Description |
|---|---|
| protected double | |
| public double[][] | Returns: the covariance matrix.Model parameters. params, double Singularity threshold. threshold)Get the covariance matrix of the optimized parameters. |
| protected double[] | Returns: the residuals.Value of the the objective function. This is
the value returned from a call to
objectiveValue)computeObjectiveValue
(whose array argument contains the model parameters).Computes the residuals. |
| public double[] | Returns: an estimate of the standard deviation of the optimized parametersModel parameters. params, double Singularity threshold (see
covarianceSingularityThreshold)computeCovariances).Computes an estimate of the standard deviation of the parameters. |
| protected RealMatrix | Returns: the weighted Jacobian: W1/2 J.Model parameters at which to compute the Jacobian. params)Computes the Jacobian matrix. |
| public double | Returns: chi-square valueGet a Chi-Square-like value assuming the N residuals follow N distinct normal distributions centered on 0 and whose variances are the reciprocal of the weights. |
| public double[][] | Returns: the covariance matrix.
Deprecated
As of 3.1. Please use
computeCovariances(double[], double)
instead.
Get the covariance matrix of the optimized parameters. |
| public double[][] | Returns: the covariance matrix.Singularity threshold. threshold)
Deprecated
As of 3.1. Please use
computeCovariances(double[], double)
instead.
Get the covariance matrix of the optimized parameters. |
| public int | |
| public double | |
| public RealMatrix | Returns: the square-root of the weight matrix.Gets the square-root of the weight matrix. |
| public double[] | Returns: an estimate of the standard deviation of the optimized parameters
Deprecated
as of version 3.1,
computeSigma(double[], double) should be used
instead.
Returns an estimate of the standard deviation of each parameter. |
| public PointVectorValuePair | optimize(int
Maximum number of function evaluations. maxEval, final DifferentiableMultivariateVectorFunction Objective function. f, final double[] Target value for the objective functions at optimum. target, final double[] Weights for the least squares cost computation. weights, final double[] Start point for optimization. startPoint)Overrides org. Implements org.
Deprecated
As of 3.1.
Optimize an objective function. |
| public PointVectorValuePair | Returns: the point/value pair giving the optimal value for objective function.Maximum number of function evaluations. maxEval, final MultivariateDifferentiableVectorFunction Objective function. f, final double[] Target value for the objective functions at optimum. target, final double[] Weights for the least squares cost computation. weights, final double[] Start point for optimization. startPoint)Overrides org. Implements org.
Deprecated
As of 3.1.
Optimize an objective function. |
| protected PointVectorValuePair | Returns: the point/value pair giving the optimal value of the objective function.Allowed number of evaluations of the objective function. maxEval, final MultivariateDifferentiableVectorFunction Objective function. f, OptimizationData... Optimization data. The following data will be looked for:
optData)
Deprecated
As of 3.1. Override is necessary only until this class's generic
argument is changed to
MultivariateDifferentiableVectorFunction.
Optimize an objective function. |
| protected void | |
| protected void | setUp()
Overrides org. Method which a subclass must override whenever its internal
state depend on the |
| private RealMatrix | Returns: the square-root of the weight matrix.Symmetric, positive-definite (weight) matrix. m)Computes the square-root of the weight matrix. |
| protected void | updateJacobian()
Deprecated
As of 3.1. Please use
computeWeightedJacobian(double[])
instead.
Update the jacobian matrix. |
| protected void |
| cols | back to summary |
|---|---|
| protected int cols
Deprecated As of 3.1. Number of columns of the jacobian matrix. | |
| cost | back to summary |
|---|---|
| protected double cost
Deprecated As of 3.1. Field to become "private" in 4.0.
Please use Cost value (square root of the sum of the residuals). | |
| DEFAULT_SINGULARITY_THRESHOLD | back to summary |
|---|---|
| private static final double DEFAULT_SINGULARITY_THRESHOLD
Deprecated As of 3.1. Singularity threshold (cf. | |
| jacobianEvaluations | back to summary |
|---|---|
| private int jacobianEvaluations Number of evaluations of the Jacobian. | |
| jF | back to summary |
|---|---|
| private MultivariateDifferentiableVectorFunction jF Objective function derivatives. | |
| objective | back to summary |
|---|---|
| protected double[] objective
Deprecated As of 3.1. Current objective function value. | |
| point | back to summary |
|---|---|
| protected double[] point
Deprecated As of 3.1. Current point. | |
| rows | back to summary |
|---|---|
| protected int rows
Deprecated As of 3.1. Number of rows of the jacobian matrix. | |
| weightedResidualJacobian | back to summary |
|---|---|
| protected double[][] weightedResidualJacobian
Deprecated As of 3.1. To be removed in 4.0. Please use
Jacobian matrix of the weighted residuals.
This matrix is in canonical form just after the calls to
| |
| weightedResiduals | back to summary |
|---|---|
| protected double[] weightedResiduals
Deprecated As of 3.1. Weighted residuals | |
| weightMatrixSqrt | back to summary |
|---|---|
| private RealMatrix weightMatrixSqrt Square-root of the weight matrix. | |
| AbstractLeastSquaresOptimizer | back to summary |
|---|---|
| protected AbstractLeastSquaresOptimizer()
Simple constructor with default settings.
The convergence check is set to a
| |
| AbstractLeastSquaresOptimizer | back to summary |
|---|---|
| protected AbstractLeastSquaresOptimizer(ConvergenceChecker<PointVectorValuePair> checker)
Deprecated as a consequence of
| |
| computeCost | back to summary |
|---|---|
| protected double computeCost(double[] residuals) Computes the cost.
| |
| computeCovariances | back to summary |
|---|---|
| public double[][] computeCovariances(double[] params, double threshold) Get the covariance matrix of the optimized parameters.
| |
| computeResiduals | back to summary |
|---|---|
| protected double[] computeResiduals(double[] objectiveValue) Computes the residuals. The residual is the difference between the observed (target) values and the model (objective function) value. There is one residual for each element of the vector-valued function.
| |
| computeSigma | back to summary |
|---|---|
| public double[] computeSigma(double[] params, double covarianceSingularityThreshold) Computes an estimate of the standard deviation of the parameters. The
returned values are the square root of the diagonal coefficients of the
covariance matrix,
| |
| computeWeightedJacobian | back to summary |
|---|---|
| protected RealMatrix computeWeightedJacobian(double[] params) Computes the Jacobian matrix.
| |
| getChiSquare | back to summary |
|---|---|
| public double getChiSquare() Get a Chi-Square-like value assuming the N residuals follow N distinct normal distributions centered on 0 and whose variances are the reciprocal of the weights.
| |
| getCovariances | back to summary |
|---|---|
| public double[][] getCovariances()
Deprecated As of 3.1. Please use Get the covariance matrix of the optimized parameters.
| |
| getCovariances | back to summary |
|---|---|
| public double[][] getCovariances(double threshold)
Deprecated As of 3.1. Please use Get the covariance matrix of the optimized parameters.
| |
| getJacobianEvaluations | back to summary |
|---|---|
public int getJacobianEvaluations()
| |
| getRMS | back to summary |
|---|---|
| public double getRMS() Get the Root Mean Square value. Get the Root Mean Square value, i.e. the root of the arithmetic mean of the square of all weighted residuals. This is related to the criterion that is minimized by the optimizer as follows: if c if the criterion, and n is the number of measurements, then the RMS is sqrt (c/n).
| |
| getWeightSquareRoot | back to summary |
|---|---|
| public RealMatrix getWeightSquareRoot() Gets the square-root of the weight matrix.
| |
| guessParametersErrors | back to summary |
|---|---|
| public double[] guessParametersErrors()
Deprecated as of version 3.1,
Returns an estimate of the standard deviation of each parameter. The
returned values are the so-called (asymptotic) standard errors on the
parameters, defined as See also Wikipedia, or MathWorld, equations (34) and (35) for a particular case.
| |
| optimize | back to summary |
|---|---|
| public PointVectorValuePair optimize(int maxEval, final DifferentiableMultivariateVectorFunction f, final double[] target, final double[] weights, final double[] startPoint) Overrides org. Implements org. Doc from org. Deprecated As of 3.1. Please use
Optimize an objective function.
Optimization is considered to be a weighted least-squares minimization.
The cost function to be minimized is
| |
| optimize | back to summary |
|---|---|
| public PointVectorValuePair optimize(final int maxEval, final MultivariateDifferentiableVectorFunction f, final double[] target, final double[] weights, final double[] startPoint) Overrides org. Implements org. Deprecated As of 3.1. Please use
Optimize an objective function.
Optimization is considered to be a weighted least-squares minimization.
The cost function to be minimized is
| |
| optimizeInternal | back to summary |
|---|---|
| protected PointVectorValuePair optimizeInternal(final int maxEval, final MultivariateDifferentiableVectorFunction f, OptimizationData... optData) Deprecated As of 3.1. Override is necessary only until this class's generic
argument is changed to Optimize an objective function.
Optimization is considered to be a weighted least-squares minimization.
The cost function to be minimized is
| |
| setCost | back to summary |
|---|---|
| protected void setCost(double cost) Sets the cost.
| |
| setUp | back to summary |
|---|---|
| protected void setUp() Overrides org. Doc from org. Method which a subclass must override whenever its internal
state depend on the
| |
| squareRoot | back to summary |
|---|---|
| private RealMatrix squareRoot(RealMatrix m) Computes the square-root of the weight matrix.
| |
| updateJacobian | back to summary |
|---|---|
| protected void updateJacobian()
Deprecated As of 3.1. Please use Update the jacobian matrix.
| |
| updateResidualsAndCost | back to summary |
|---|---|
| protected void updateResidualsAndCost()
Deprecated As of 3.1. Please use Update the residuals array and cost function value.
| |