Top Description Fields Constructors Methods
org.apache.commons.math3.optim.nonlinear.vector

public abstract Class MultivariateVectorOptimizer

extends BaseMultivariateOptimizer<PointVectorValuePair>
Class Inheritance
Known Direct Subclasses
org.apache.commons.math3.optim.nonlinear.vector.JacobianMultivariateVectorOptimizer
Annotations
@Deprecated
Imports
org.apache.commons.math3.exception.TooManyEvaluationsException, .DimensionMismatchException, org.apache.commons.math3.analysis.MultivariateVectorFunction, org.apache.commons.math3.optim.OptimizationData, .BaseMultivariateOptimizer, .ConvergenceChecker, .PointVectorValuePair, org.apache.commons.math3.linear.RealMatrix

Deprecated

Base class for a multivariate vector function optimizer.
Since
3.1

Field Summary

Modifier and TypeField and Description
private MultivariateVectorFunction
model

Model function.

private double[]
target

Target values for the model function at optimum.

private RealMatrix
weightMatrix

Weight matrix.

Constructor Summary

AccessConstructor and Description
protected

Method Summary

Modifier and TypeMethod and Description
private void
protected double[]

Returns:

the objective function value at the specified point.
computeObjectiveValue
(double[]
Point at which the objective function must be evaluated.
params
)

Computes the objective function value.

public double[]

Returns:

the target values.
getTarget
()

Gets the observed values to be matched by the objective vector function.

public int

Returns:

the length of the target vector.
getTargetSize
()

Gets the number of observed values.

public RealMatrix

Returns:

the weight matrix.
getWeight
()

Gets the weight matrix of the observations.

public PointVectorValuePair

Returns:

a point/value pair that satisfies the convergence criteria.
optimize
(OptimizationData...
Optimization data. In addition to those documented in BaseMultivariateOptimizer, this method will register the following data:
optData
)

Overrides org.apache.commons.math3.optim.BaseMultivariateOptimizer.optimize.

Stores data and performs the optimization.

protected void
parseOptimizationData(OptimizationData...
Optimization data. The following data will be looked for:
optData
)

Overrides org.apache.commons.math3.optim.BaseMultivariateOptimizer.parseOptimizationData.

Scans the list of (required and optional) optimization data that characterize the problem.

Inherited from org.apache.commons.math3.optim.BaseMultivariateOptimizer:
getLowerBoundgetStartPointgetUpperBound

Field Detail

modelback to summary
private MultivariateVectorFunction model

Model function.

targetback to summary
private double[] target

Target values for the model function at optimum.

weightMatrixback to summary
private RealMatrix weightMatrix

Weight matrix.

Constructor Detail

MultivariateVectorOptimizerback to summary
protected MultivariateVectorOptimizer(ConvergenceChecker<PointVectorValuePair> checker)
Parameters
checker:ConvergenceChecker<PointVectorValuePair>

Convergence checker.

Method Detail

checkParametersback to summary
private void checkParameters()

Hides org.apache.commons.math3.optim.BaseMultivariateOptimizer.checkParameters.

Check parameters consistency.

Exceptions
DimensionMismatchException:
if target and weightMatrix have inconsistent dimensions.
computeObjectiveValueback to summary
protected double[] computeObjectiveValue(double[] params)

Computes the objective function value. This method must be called by subclasses to enforce the evaluation counter limit.

Parameters
params:double[]

Point at which the objective function must be evaluated.

Returns:double[]

the objective function value at the specified point.

Exceptions
TooManyEvaluationsException:
if the maximal number of evaluations (of the model vector function) is exceeded.
getTargetback to summary
public double[] getTarget()

Gets the observed values to be matched by the objective vector function.

Returns:double[]

the target values.

getTargetSizeback to summary
public int getTargetSize()

Gets the number of observed values.

Returns:int

the length of the target vector.

getWeightback to summary
public RealMatrix getWeight()

Gets the weight matrix of the observations.

Returns:RealMatrix

the weight matrix.

optimizeback to summary
public PointVectorValuePair optimize(OptimizationData... optData) throws TooManyEvaluationsException, DimensionMismatchException

Overrides org.apache.commons.math3.optim.BaseMultivariateOptimizer.optimize.

Doc from org.apache.commons.math3.optim.BaseMultivariateOptimizer.optimize.

Stores data and performs the optimization.

The list of parameters is open-ended so that sub-classes can extend it with arguments specific to their concrete implementations.

When the method is called multiple times, instance data is overwritten only when actually present in the list of arguments: when not specified, data set in a previous call is retained (and thus is optional in subsequent calls).

Important Note

Subclasses must override parseOptimizationData(OptimizationData[]) if they need to register their own options; but then, they must also call super.parseOptimizationData(optData) within that method.

Parameters
optData:OptimizationData[]

Optimization data. In addition to those documented in BaseMultivariateOptimizer, this method will register the following data:

Returns:PointVectorValuePair

a point/value pair that satisfies the convergence criteria.

Annotations
@Override
Exceptions
TooManyEvaluationsException:
if the maximal number of evaluations is exceeded.
DimensionMismatchException:
if the initial guess, target, and weight arguments have inconsistent dimensions.
parseOptimizationDataback to summary
protected void parseOptimizationData(OptimizationData... optData)

Overrides org.apache.commons.math3.optim.BaseMultivariateOptimizer.parseOptimizationData.

Scans the list of (required and optional) optimization data that characterize the problem.

Parameters
optData:OptimizationData[]

Optimization data. The following data will be looked for:

Annotations
@Override