LSST Applications  21.0.0-172-gfb10e10a+18fedfabac,22.0.0+297cba6710,22.0.0+80564b0ff1,22.0.0+8d77f4f51a,22.0.0+a28f4c53b1,22.0.0+dcf3732eb2,22.0.1-1-g7d6de66+2a20fdde0d,22.0.1-1-g8e32f31+297cba6710,22.0.1-1-geca5380+7fa3b7d9b6,22.0.1-12-g44dc1dc+2a20fdde0d,22.0.1-15-g6a90155+515f58c32b,22.0.1-16-g9282f48+790f5f2caa,22.0.1-2-g92698f7+dcf3732eb2,22.0.1-2-ga9b0f51+7fa3b7d9b6,22.0.1-2-gd1925c9+bf4f0e694f,22.0.1-24-g1ad7a390+a9625a72a8,22.0.1-25-g5bf6245+3ad8ecd50b,22.0.1-25-gb120d7b+8b5510f75f,22.0.1-27-g97737f7+2a20fdde0d,22.0.1-32-gf62ce7b1+aa4237961e,22.0.1-4-g0b3f228+2a20fdde0d,22.0.1-4-g243d05b+871c1b8305,22.0.1-4-g3a563be+32dcf1063f,22.0.1-4-g44f2e3d+9e4ab0f4fa,22.0.1-42-gca6935d93+ba5e5ca3eb,22.0.1-5-g15c806e+85460ae5f3,22.0.1-5-g58711c4+611d128589,22.0.1-5-g75bb458+99c117b92f,22.0.1-6-g1c63a23+7fa3b7d9b6,22.0.1-6-g50866e6+84ff5a128b,22.0.1-6-g8d3140d+720564cf76,22.0.1-6-gd805d02+cc5644f571,22.0.1-8-ge5750ce+85460ae5f3,master-g6e05de7fdc+babf819c66,master-g99da0e417a+8d77f4f51a,w.2021.48
LSST Data Management Base Package
Public Member Functions | Public Attributes | List of all members
lsst::meas::modelfit::OptimizerControl Class Reference

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" ; More...
 
double skipSR1UpdateThreshold
 "Skip the SR1 update if |v||s| / (|v||s|) is less than this threshold" ; More...
 
double minTrustRadiusThreshold
 "If the trust radius falls below this threshold, consider the algorithm converged" ; More...
 
double gradientThreshold
 "If the maximum of the gradient falls below this threshold, consider the algorithm converged" ; More...
 
double numDiffRelStep
 "relative step size used for numerical derivatives (added to other steps)" ; More...
 
double numDiffAbsStep
 "absolute step size used for numerical derivatives (added to other steps)" ; More...
 
double numDiffTrustRadiusStep
 "step size (in units of trust radius) used for numerical derivatives (added to relative step)" ; More...
 
double stepAcceptThreshold
 "steps with reduction ratio greater than this are accepted" ; More...
 
double trustRegionInitialSize
 "the initial trust region will be set to this value" ; More...
 
double trustRegionGrowReductionRatio
 "steps with reduction radio greater than this may increase the trust radius" ; More...
 
double trustRegionGrowStepFraction
 "steps with length this fraction of the trust radius may increase the trust radius" ; More...
 
double trustRegionGrowFactor
 "when increase the trust region size, multiply the radius by this factor" ; More...
 
double trustRegionShrinkReductionRatio
 "steps with reduction radio less than this will decrease the trust radius" ; More...
 
double trustRegionShrinkFactor
 "when reducing the trust region size, multiply the radius by this factor" ; More...
 
double trustRegionSolverTolerance
 "value passed as the tolerance to solveTrustRegion" ; More...
 
int maxInnerIterations
 "maximum number of iterations (i.e. function evaluations and trust region subproblems) per step" ; More...
 
int maxOuterIterations
 "maximum number of steps" ; More...
 
bool doSaveIterations
 "whether to save all iterations for debugging purposes" ; More...
 

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,

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.

279  :
280  noSR1Term(false), skipSR1UpdateThreshold(1E-8),
282  gradientThreshold(1E-5),
284  stepAcceptThreshold(0.0),
290  trustRegionShrinkFactor(1.0/3.0),
292  maxInnerIterations(20),
293  maxOuterIterations(500),
294  doSaveIterations(false)
295  {}
double trustRegionGrowStepFraction
"steps with length this fraction of the trust radius may increase the trust radius" ;
Definition: optimizer.h:242
bool noSR1Term
"If true, ignore the SR1 update term in the Hessian, resulting in a Levenberg-Marquardt-like method" ...
Definition: optimizer.h:192
double trustRegionShrinkFactor
"when reducing the trust region size, multiply the radius by this factor" ;
Definition: optimizer.h:257
double trustRegionShrinkReductionRatio
"steps with reduction radio less than this will decrease the trust radius" ;
Definition: optimizer.h:252
double numDiffAbsStep
"absolute step size used for numerical derivatives (added to other steps)" ;
Definition: optimizer.h:217
double numDiffTrustRadiusStep
"step size (in units of trust radius) used for numerical derivatives (added to relative step)" ;
Definition: optimizer.h:222
double gradientThreshold
"If the maximum of the gradient falls below this threshold, consider the algorithm converged" ;
Definition: optimizer.h:207
double numDiffRelStep
"relative step size used for numerical derivatives (added to other steps)" ;
Definition: optimizer.h:212
double trustRegionGrowReductionRatio
"steps with reduction radio greater than this may increase the trust radius" ;
Definition: optimizer.h:237
double trustRegionGrowFactor
"when increase the trust region size, multiply the radius by this factor" ;
Definition: optimizer.h:247
int maxInnerIterations
"maximum number of iterations (i.e. function evaluations and trust region subproblems) per step" ;
Definition: optimizer.h:267
double skipSR1UpdateThreshold
"Skip the SR1 update if |v||s| / (|v||s|) is less than this threshold" ;
Definition: optimizer.h:197
double minTrustRadiusThreshold
"If the trust radius falls below this threshold, consider the algorithm converged" ;
Definition: optimizer.h:202
bool doSaveIterations
"whether to save all iterations for debugging purposes" ;
Definition: optimizer.h:277
double stepAcceptThreshold
"steps with reduction ratio greater than this are accepted" ;
Definition: optimizer.h:227
int maxOuterIterations
"maximum number of steps" ;
Definition: optimizer.h:272
double trustRegionInitialSize
"the initial trust region will be set to this value" ;
Definition: optimizer.h:232
double trustRegionSolverTolerance
"value passed as the tolerance to solveTrustRegion" ;
Definition: optimizer.h:262

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: