simpeg.directives.BetaSchedule#

class simpeg.directives.BetaSchedule(coolingFactor=8.0, coolingRate=3, **kwargs)[source]#

Bases: InversionDirective

Reduce trade-off parameter (beta) at successive iterations using a cooling schedule.

Updates the beta property in the associated simpeg.inverse_problem.BaseInvProblem while the inversion is running. For linear least-squares problems, the optimization problem can be solved in a single step and the cooling rate can be set to 1. For non-linear optimization problems, multiple steps are required obtain the minimizer for a fixed trade-off parameter. In this case, the cooling rate should be larger than 1.

Parameters:

coolingFactorfloat: The factor by which the trade-off parameter is decreased when updated. The preexisting value of the trade-off parameter is divided by the cooling factor.
coolingRateint: Sets the number of successive iterations before the trade-off parameter is reduced. Use 1 for linear least-squares optimization problems. Use 2 for weakly non-linear optimization problems. Use 3 for general non-linear optimization problems.

Attributes

`coolingFactor`	Beta is divided by this value every coolingRate iterations.
`coolingRate`	Cool after this number of iterations.
`dmisfit`	Data misfit associated with the directive.
`invProb`	Inverse problem associated with the directive.
`inversion`	Inversion object associated with the directive.
`opt`	Optimization algorithm associated with the directive.
`reg`	Regularization associated with the directive.
`simulation`	Return simulation for all data misfits.
`survey`	Return survey for all data misfits
`verbose`	Whether or not to print debugging information.

Methods

`endIter`()	Update inversion parameter(s) according to directive at end of iteration.
`finish`()	Update inversion parameter(s) according to directive at end of inversion.
`initialize`()	Initialize inversion parameter(s) according to directive.
`validate`([directiveList])	Validate directive.