ITK
6.0.0
Insight Toolkit
|
#include <itkMultiGradientOptimizerv4.h>
Multiple gradient-based optimizers are combined in order to perform a multi-objective optimization.
This optimizer will do a combined gradient descent optimization using whatever metric/optimizer gradient sub-optimizers are passed to it by the user. The learning rate or scale estimator for each sub-optimizer controls the relative weight of each metric in the optimization. Denote the weights as \( w_1 \) and \( w_2 \) then the MultiGradientOptimizer will optimize \( \sum_i w_i Metric_i \) by using update rule:
\[ params_{new} = params_{old} + \frac{1}{N_{Metrics}} * ( \sum_i w_i Grad(Metric_i) ) \]
The test for this class illustrates the expected behavior.
Definition at line 47 of file itkMultiGradientOptimizerv4.h.
Public Member Functions | |
const MetricValuesListType & | GetMetricValuesList () const |
const char * | GetNameOfClass () const override |
OptimizersListType & | GetOptimizersList () |
const StopConditionObjectToObjectOptimizerEnum & | GetStopCondition () const override |
StopConditionReturnStringType | GetStopConditionDescription () const override |
void | ResumeOptimization () override |
void | SetOptimizersList (OptimizersListType &p) |
void | StartOptimization (bool doOnlyInitialization=false) override |
void | StopOptimization () override |
Public Member Functions inherited from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType > | |
virtual void | EstimateLearningRate () |
virtual const TInternalComputationValueType & | GetConvergenceValue () const |
const char * | GetNameOfClass () const override |
void | ResumeOptimization () override |
virtual void | SetConvergenceWindowSize (SizeValueType _arg) |
virtual void | SetMinimumConvergenceValue (TInternalComputationValueType _arg) |
void | StartOptimization (bool doOnlyInitialization=false) override |
void | StopOptimization () override |
virtual void | SetLearningRate (TInternalComputationValueType _arg) |
virtual const TInternalComputationValueType & | GetLearningRate () const |
virtual void | SetMaximumStepSizeInPhysicalUnits (TInternalComputationValueType _arg) |
virtual const TInternalComputationValueType & | GetMaximumStepSizeInPhysicalUnits () const |
virtual void | SetDoEstimateLearningRateAtEachIteration (bool _arg) |
virtual const bool & | GetDoEstimateLearningRateAtEachIteration () const |
virtual void | DoEstimateLearningRateAtEachIterationOn () |
virtual void | SetDoEstimateLearningRateOnce (bool _arg) |
virtual const bool & | GetDoEstimateLearningRateOnce () const |
virtual void | DoEstimateLearningRateOnceOn () |
virtual void | SetReturnBestParametersAndValue (bool _arg) |
virtual const bool & | GetReturnBestParametersAndValue () const |
virtual void | ReturnBestParametersAndValueOn () |
Public Member Functions inherited from itk::GradientDescentOptimizerBasev4Template< TInternalComputationValueType > | |
virtual const DerivativeType & | GetGradient () const |
const char * | GetNameOfClass () const override |
virtual const StopConditionObjectToObjectOptimizerEnum & | GetStopCondition () const |
StopConditionReturnStringType | GetStopConditionDescription () const override |
virtual void | ModifyGradientByLearningRateOverSubRange (const IndexRangeType &subrange)=0 |
virtual void | ModifyGradientByScalesOverSubRange (const IndexRangeType &subrange)=0 |
virtual void | ResumeOptimization ()=0 |
void | StartOptimization (bool doOnlyInitialization=false) override |
virtual void | StopOptimization () |
virtual void | ModifyGradientByScales () |
virtual void | ModifyGradientByLearningRate () |
Public Member Functions inherited from itk::ObjectToObjectOptimizerBaseTemplate< TInternalComputationValueType > | |
virtual bool | CanUseScales () const |
virtual SizeValueType | GetCurrentIteration () const |
virtual const MeasureType & | GetCurrentMetricValue () const |
virtual const ParametersType & | GetCurrentPosition () const |
const char * | GetNameOfClass () const override |
virtual SizeValueType | GetNumberOfIterations () const |
virtual const ThreadIdType & | GetNumberOfWorkUnits () const |
virtual const ScalesType & | GetScales () const |
virtual const bool & | GetScalesAreIdentity () const |
bool | GetScalesInitialized () const |
virtual StopConditionReturnStringType | GetStopConditionDescription () const=0 |
virtual const MeasureType & | GetValue () const |
virtual const ScalesType & | GetWeights () const |
virtual const bool & | GetWeightsAreIdentity () const |
virtual void | SetNumberOfIterations (SizeValueType _arg) |
virtual void | SetNumberOfWorkUnits (ThreadIdType number) |
virtual void | SetScalesEstimator (ScalesEstimatorType *_arg) |
virtual void | SetWeights (ScalesType _arg) |
virtual void | StartOptimization (bool doOnlyInitialization=false) |
virtual void | SetMetric (MetricType *_arg) |
virtual MetricType * | GetModifiableMetric () |
virtual void | SetScales (const ScalesType &scales) |
virtual void | SetDoEstimateScales (bool _arg) |
virtual const bool & | GetDoEstimateScales () const |
virtual void | DoEstimateScalesOn () |
Public Member Functions inherited from itk::Object | |
unsigned long | AddObserver (const EventObject &event, Command *cmd) const |
unsigned long | AddObserver (const EventObject &event, std::function< void(const EventObject &)> function) const |
LightObject::Pointer | CreateAnother () const override |
virtual void | DebugOff () const |
virtual void | DebugOn () const |
Command * | GetCommand (unsigned long tag) |
bool | GetDebug () const |
MetaDataDictionary & | GetMetaDataDictionary () |
const MetaDataDictionary & | GetMetaDataDictionary () const |
virtual ModifiedTimeType | GetMTime () const |
const char * | GetNameOfClass () const override |
virtual const TimeStamp & | GetTimeStamp () const |
bool | HasObserver (const EventObject &event) const |
void | InvokeEvent (const EventObject &) |
void | InvokeEvent (const EventObject &) const |
virtual void | Modified () const |
void | Register () const override |
void | RemoveAllObservers () |
void | RemoveObserver (unsigned long tag) const |
void | SetDebug (bool debugFlag) const |
void | SetReferenceCount (int) override |
void | UnRegister () const noexcept override |
void | SetMetaDataDictionary (const MetaDataDictionary &rhs) |
void | SetMetaDataDictionary (MetaDataDictionary &&rrhs) |
virtual void | SetObjectName (std::string _arg) |
virtual const std::string & | GetObjectName () const |
Public Member Functions inherited from itk::LightObject | |
Pointer | Clone () const |
virtual Pointer | CreateAnother () const |
virtual void | Delete () |
virtual const char * | GetNameOfClass () const |
virtual int | GetReferenceCount () const |
void | Print (std::ostream &os, Indent indent=0) const |
virtual void | Register () const |
virtual void | SetReferenceCount (int) |
virtual void | UnRegister () const noexcept |
Static Public Member Functions | |
static Pointer | New () |
Static Public Member Functions inherited from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType > | |
static Pointer | New () |
Static Public Member Functions inherited from itk::Object | |
static bool | GetGlobalWarningDisplay () |
static void | GlobalWarningDisplayOff () |
static void | GlobalWarningDisplayOn () |
static Pointer | New () |
static void | SetGlobalWarningDisplay (bool val) |
Static Public Member Functions inherited from itk::LightObject | |
static void | BreakOnError () |
static Pointer | New () |
Protected Member Functions | |
void | PrintSelf (std::ostream &os, Indent indent) const override |
MultiGradientOptimizerv4Template () | |
~MultiGradientOptimizerv4Template () override=default | |
Protected Member Functions inherited from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType > | |
virtual void | AdvanceOneStep () |
GradientDescentOptimizerv4Template () | |
void | ModifyGradientByLearningRateOverSubRange (const IndexRangeType &subrange) override |
void | ModifyGradientByScalesOverSubRange (const IndexRangeType &subrange) override |
void | PrintSelf (std::ostream &os, Indent indent) const override |
~GradientDescentOptimizerv4Template () override=default | |
Protected Member Functions inherited from itk::GradientDescentOptimizerBasev4Template< TInternalComputationValueType > | |
void | PrintSelf (std::ostream &os, Indent indent) const override |
GradientDescentOptimizerBasev4Template () | |
~GradientDescentOptimizerBasev4Template () override=default | |
Protected Member Functions inherited from itk::ObjectToObjectOptimizerBaseTemplate< TInternalComputationValueType > | |
void | PrintSelf (std::ostream &os, Indent indent) const override |
ObjectToObjectOptimizerBaseTemplate () | |
~ObjectToObjectOptimizerBaseTemplate () override | |
Protected Member Functions inherited from itk::Object | |
Object () | |
bool | PrintObservers (std::ostream &os, Indent indent) const |
void | PrintSelf (std::ostream &os, Indent indent) const override |
virtual void | SetTimeStamp (const TimeStamp &timeStamp) |
~Object () override | |
Protected Member Functions inherited from itk::LightObject | |
virtual LightObject::Pointer | InternalClone () const |
LightObject () | |
virtual void | PrintHeader (std::ostream &os, Indent indent) const |
virtual void | PrintSelf (std::ostream &os, Indent indent) const |
virtual void | PrintTrailer (std::ostream &os, Indent indent) const |
virtual | ~LightObject () |
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::ConstPointer = SmartPointer<const Self> |
Definition at line 57 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::DerivativeType = typename MetricType::DerivativeType |
Derivative type
Definition at line 88 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::InternalComputationValueType = TInternalComputationValueType |
It should be possible to derive the internal computation type from the class object.
Definition at line 81 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::LocalOptimizerPointer = typename itk::GradientDescentOptimizerv4Template<TInternalComputationValueType>::Pointer |
Definition at line 66 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::LocalOptimizerType = itk::GradientDescentOptimizerv4Template<TInternalComputationValueType> |
Definition at line 65 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::MetricTypePointer = typename MetricType::Pointer |
Definition at line 85 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::MetricValuesListType = std::vector<MeasureType> |
Definition at line 92 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::OptimizerPointer = typename OptimizerType::Pointer |
Definition at line 70 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::OptimizersListSizeType = typename OptimizersListType::size_type |
Definition at line 72 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::OptimizersListType = std::vector<LocalOptimizerPointer> |
Definition at line 71 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::OptimizerType = ObjectToObjectOptimizerBaseTemplate<TInternalComputationValueType> |
Definition at line 69 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::Pointer = SmartPointer<Self> |
Definition at line 56 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::Self = MultiGradientOptimizerv4Template |
Standard class type aliases.
Definition at line 54 of file itkMultiGradientOptimizerv4.h.
using itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::Superclass = GradientDescentOptimizerv4Template<TInternalComputationValueType> |
Definition at line 55 of file itkMultiGradientOptimizerv4.h.
|
protected |
Default constructor
|
overrideprotecteddefault |
Default constructor
const MetricValuesListType & itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::GetMetricValuesList | ( | ) | const |
Get the list of metric values that we produced after the multi-objective search.
|
overridevirtual |
Reimplemented from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType >.
OptimizersListType & itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::GetOptimizersList | ( | ) |
Get the list of optimizers currently held.
|
inlineoverridevirtual |
Get stop condition enum
Reimplemented from itk::GradientDescentOptimizerBasev4Template< TInternalComputationValueType >.
Definition at line 96 of file itkMultiGradientOptimizerv4.h.
|
overridevirtual |
Get the reason for termination
Reimplemented from itk::GradientDescentOptimizerBasev4Template< TInternalComputationValueType >.
|
static |
Method for creation through the object factory.
|
overrideprotectedvirtual |
Methods invoked by Print() to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.
Reimplemented from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType >.
|
overridevirtual |
Resume the optimization. Can be called after StopOptimization to resume. The bulk of the optimization work loop is here.
Reimplemented from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType >.
void itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >::SetOptimizersList | ( | OptimizersListType & | p | ) |
Set the list of optimizers to combine.
|
overridevirtual |
Begin the optimization
Reimplemented from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType >.
|
overridevirtual |
Stop optimization. The object is left in a state so the optimization can be resumed by calling ResumeOptimization.
Reimplemented from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType >.
|
protected |
Definition at line 147 of file itkMultiGradientOptimizerv4.h.
|
protected |
Definition at line 145 of file itkMultiGradientOptimizerv4.h.
|
protected |
Definition at line 146 of file itkMultiGradientOptimizerv4.h.
|
protected |
Definition at line 144 of file itkMultiGradientOptimizerv4.h.
|
protected |
Definition at line 141 of file itkMultiGradientOptimizerv4.h.
|
protected |
Definition at line 142 of file itkMultiGradientOptimizerv4.h.
|
protected |
Definition at line 143 of file itkMultiGradientOptimizerv4.h.