Configuration object for Optimizer. More...

#include <optimizer.h>

Public Member Functions
	OptimizerControl ()

Public Attributes
bool	noSR1Term
	"If true, ignore the SR1 update term in the Hessian, resulting in a Levenberg-Marquardt-like method" ;

double	skipSR1UpdateThreshold
	"Skip the SR1 update if \|v\|\|s\| / (\|v\|\|s\|) is less than this threshold" ;

double	minTrustRadiusThreshold
	"If the trust radius falls below this threshold, consider the algorithm converged" ;

double	gradientThreshold
	"If the maximum of the gradient falls below this threshold, consider the algorithm converged" ;

double	numDiffRelStep
	"relative step size used for numerical derivatives (added to other steps)" ;

double	numDiffAbsStep
	"absolute step size used for numerical derivatives (added to other steps)" ;

double	numDiffTrustRadiusStep
	"step size (in units of trust radius) used for numerical derivatives (added to relative step)" ;

double	stepAcceptThreshold
	"steps with reduction ratio greater than this are accepted" ;

double	trustRegionInitialSize
	"the initial trust region will be set to this value" ;

double	trustRegionGrowReductionRatio
	"steps with reduction radio greater than this may increase the trust radius" ;

double	trustRegionGrowStepFraction
	"steps with length this fraction of the trust radius may increase the trust radius" ;

double	trustRegionGrowFactor
	"when increase the trust region size, multiply the radius by this factor" ;

double	trustRegionShrinkReductionRatio
	"steps with reduction radio less than this will decrease the trust radius" ;

double	trustRegionShrinkFactor
	"when reducing the trust region size, multiply the radius by this factor" ;

double	trustRegionSolverTolerance
	"value passed as the tolerance to solveTrustRegion" ;

int	maxInnerIterations
	"maximum number of iterations (i.e. function evaluations and trust region subproblems) per step" ;

int	maxOuterIterations
	"maximum number of steps" ;

bool	doSaveIterations
	"whether to save all iterations for debugging purposes" ;

Detailed Description

Configuration object for Optimizer.

Many of these configuration options pertain to how the trust region is updated. It's easiest to understand these together rather than separately. At each iteration, a quadratic model of the objective function is formed. We can use this model to predict how we expect the objective function to behave over a step, and compare it to how the actual objective function behaves. To do this, we'll use the ratio of the actual reduction in the objective function to the predicted reduction in the objective function, and call this \(\rho\). Then,

the step is accepted, and the parameters updated, when \(\rho >\) stepAcceptThreshold.
if \(\rho > \) trustRegionGrowReductionRatio and the length of the step is greater than trustRegionGrowStepFraction times the current trust region radius, the trust region radius will be multiplied by trustRegionGrowFactor.
if trustRegionShrinkMinReductionRatio \(< \rho < \) trustRegionShrinkMaxReductionRatio, the trust region radius will be multiplied by trustRegionShrinkFactor.

Definition at line 187 of file optimizer.h.

Constructor & Destructor Documentation

◆ OptimizerControl()

lsst::meas::modelfit::OptimizerControl::OptimizerControl ( )

inline

Definition at line 279 of file optimizer.h.

                       :
        noSR1Term(false), skipSR1UpdateThreshold(1E-8),
        minTrustRadiusThreshold(1E-5),
        gradientThreshold(1E-5),
        numDiffRelStep(0.0), numDiffAbsStep(0.0), numDiffTrustRadiusStep(0.1),
        stepAcceptThreshold(0.0),
        trustRegionInitialSize(1.0),
        trustRegionGrowReductionRatio(0.75),
        trustRegionGrowStepFraction(0.8),
        trustRegionGrowFactor(2.0),
        trustRegionShrinkReductionRatio(0.25),
        trustRegionShrinkFactor(1.0/3.0),
        trustRegionSolverTolerance(1E-8),
        maxInnerIterations(20),
        maxOuterIterations(500),
        doSaveIterations(false)
    {}

Member Data Documentation

◆ doSaveIterations

bool lsst::meas::modelfit::OptimizerControl::doSaveIterations

"whether to save all iterations for debugging purposes" ;

Definition at line 277 of file optimizer.h.

◆ gradientThreshold

double lsst::meas::modelfit::OptimizerControl::gradientThreshold

"If the maximum of the gradient falls below this threshold, consider the algorithm converged" ;

Definition at line 207 of file optimizer.h.

◆ maxInnerIterations

int lsst::meas::modelfit::OptimizerControl::maxInnerIterations

"maximum number of iterations (i.e. function evaluations and trust region subproblems) per step" ;

Definition at line 267 of file optimizer.h.

◆ maxOuterIterations

int lsst::meas::modelfit::OptimizerControl::maxOuterIterations

"maximum number of steps" ;

Definition at line 272 of file optimizer.h.

◆ minTrustRadiusThreshold

double lsst::meas::modelfit::OptimizerControl::minTrustRadiusThreshold

"If the trust radius falls below this threshold, consider the algorithm converged" ;

Definition at line 202 of file optimizer.h.

◆ noSR1Term

bool lsst::meas::modelfit::OptimizerControl::noSR1Term

"If true, ignore the SR1 update term in the Hessian, resulting in a Levenberg-Marquardt-like method" ;

Definition at line 192 of file optimizer.h.

◆ numDiffAbsStep

double lsst::meas::modelfit::OptimizerControl::numDiffAbsStep

"absolute step size used for numerical derivatives (added to other steps)" ;

Definition at line 217 of file optimizer.h.

◆ numDiffRelStep

double lsst::meas::modelfit::OptimizerControl::numDiffRelStep

"relative step size used for numerical derivatives (added to other steps)" ;

Definition at line 212 of file optimizer.h.

◆ numDiffTrustRadiusStep

double lsst::meas::modelfit::OptimizerControl::numDiffTrustRadiusStep

"step size (in units of trust radius) used for numerical derivatives (added to relative step)" ;

Definition at line 222 of file optimizer.h.

◆ skipSR1UpdateThreshold

double lsst::meas::modelfit::OptimizerControl::skipSR1UpdateThreshold

"Skip the SR1 update if |v||s| / (|v||s|) is less than this threshold" ;

Definition at line 197 of file optimizer.h.

◆ stepAcceptThreshold

double lsst::meas::modelfit::OptimizerControl::stepAcceptThreshold

"steps with reduction ratio greater than this are accepted" ;

Definition at line 227 of file optimizer.h.

◆ trustRegionGrowFactor

double lsst::meas::modelfit::OptimizerControl::trustRegionGrowFactor

"when increase the trust region size, multiply the radius by this factor" ;

Definition at line 247 of file optimizer.h.

◆ trustRegionGrowReductionRatio

double lsst::meas::modelfit::OptimizerControl::trustRegionGrowReductionRatio

"steps with reduction radio greater than this may increase the trust radius" ;

Definition at line 237 of file optimizer.h.

◆ trustRegionGrowStepFraction

double lsst::meas::modelfit::OptimizerControl::trustRegionGrowStepFraction

"steps with length this fraction of the trust radius may increase the trust radius" ;

Definition at line 242 of file optimizer.h.

◆ trustRegionInitialSize

double lsst::meas::modelfit::OptimizerControl::trustRegionInitialSize

"the initial trust region will be set to this value" ;

Definition at line 232 of file optimizer.h.

◆ trustRegionShrinkFactor

double lsst::meas::modelfit::OptimizerControl::trustRegionShrinkFactor

"when reducing the trust region size, multiply the radius by this factor" ;

Definition at line 257 of file optimizer.h.

◆ trustRegionShrinkReductionRatio

double lsst::meas::modelfit::OptimizerControl::trustRegionShrinkReductionRatio

"steps with reduction radio less than this will decrease the trust radius" ;

Definition at line 252 of file optimizer.h.

◆ trustRegionSolverTolerance

double lsst::meas::modelfit::OptimizerControl::trustRegionSolverTolerance

"value passed as the tolerance to solveTrustRegion" ;

Definition at line 262 of file optimizer.h.

The documentation for this class was generated from the following file:

/j/snowflake/release/lsstsw/stack/lsst-scipipe-9.0.0/Linux64/meas_modelfit/ga5288a1d22+2a84bb7594/include/lsst/meas/modelfit/optimizer.h

Public Member Functions

Public Attributes