|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.commons.math3.optim.BaseOptimizer<UnivariatePointValuePair>
org.apache.commons.math3.optim.univariate.UnivariateOptimizer
org.apache.commons.math3.optim.univariate.MultiStartUnivariateOptimizer
public class MultiStartUnivariateOptimizer
Special implementation of the UnivariateOptimizer
interface
adding multi-start features to an existing optimizer.
This class wraps an optimizer in order to use it several times in
turn with different starting points (trying to avoid being trapped
in a local extremum when looking for a global one).
Field Summary |
---|
Fields inherited from class org.apache.commons.math3.optim.BaseOptimizer |
---|
evaluations, iterations |
Constructor Summary | |
---|---|
MultiStartUnivariateOptimizer(UnivariateOptimizer optimizer,
int starts,
RandomGenerator generator)
Create a multi-start optimizer from a single-start optimizer. |
Method Summary | |
---|---|
protected UnivariatePointValuePair |
doOptimize()
Performs the bulk of the optimization algorithm. |
int |
getEvaluations()
Gets the number of evaluations of the objective function. |
UnivariatePointValuePair[] |
getOptima()
Gets all the optima found during the last call to optimize . |
UnivariatePointValuePair |
optimize(OptimizationData... optData)
Stores data and performs the optimization. |
Methods inherited from class org.apache.commons.math3.optim.univariate.UnivariateOptimizer |
---|
computeObjectiveValue, getGoalType, getMax, getMin, getStartValue |
Methods inherited from class org.apache.commons.math3.optim.BaseOptimizer |
---|
getConvergenceChecker, getIterations, getMaxEvaluations, getMaxIterations, incrementEvaluationCount, incrementIterationCount |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public MultiStartUnivariateOptimizer(UnivariateOptimizer optimizer, int starts, RandomGenerator generator)
optimizer
- Single-start optimizer to wrap.starts
- Number of starts to perform. If starts == 1
,
the optimize
methods will return the same solution as
optimizer
would.generator
- Random generator to use for restarts.
NotStrictlyPositiveException
- if starts < 1
.Method Detail |
---|
public int getEvaluations()
optimize
method. It is 0 if the method has not been
called yet.
getEvaluations
in class BaseOptimizer<UnivariatePointValuePair>
public UnivariatePointValuePair[] getOptima()
optimize
.
The optimizer stores all the optima found during a set of
restarts. The optimize
method returns the best point only.
This method returns all the points found at the end of each starts,
including the best one already returned by the optimize
method.
null
elements
corresponding to the runs that did not converge. This means all
elements will be null
if the optimize
method did throw
an exception.
This also means that if the first element is not null
, it is
the best point found across all starts.
MathIllegalStateException
- if optimize
has not been called.public UnivariatePointValuePair optimize(OptimizationData... optData)
optimize
in class UnivariateOptimizer
optData
- Optimization data.
The following data will be looked for:
MathIllegalStateException
- if optData
does not contain an
instance of MaxEval
or SearchInterval
.protected UnivariatePointValuePair doOptimize()
doOptimize
in class BaseOptimizer<UnivariatePointValuePair>
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |