#include <itkMultiGradientOptimizerv4.h>

Inheritance diagram for itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >:

Collaboration diagram for itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >:

Detailed Description

template<typename TInternalComputationValueType>
class itk::MultiGradientOptimizerv4Template< TInternalComputationValueType >

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 scaleestimator 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) )$

Note: The scales, learning rates and weights options must be set individually for each sub-optimizer, and have no effect when set on this class.

The test for this class illustrates the expected behavior.

Definition at line 46 of file itkMultiGradientOptimizerv4.h.

Public Types
typedef SmartPointer< const Self >	ConstPointer

typedef MetricType::DerivativeType	DerivativeType

typedef TInternalComputationValueType	InternalComputationValueType

typedef itk::GradientDescentOptimizerv4Template < TInternalComputationValueType > ::Pointer	LocalOptimizerPointer

typedef itk::GradientDescentOptimizerv4Template < TInternalComputationValueType >	LocalOptimizerType

typedef Superclass::MeasureType	MeasureType

typedef Superclass::MetricType	MetricType

typedef MetricType::Pointer	MetricTypePointer

typedef std::vector< MeasureType >	MetricValuesListType

typedef OptimizerType::Pointer	OptimizerPointer

typedef OptimizersListType::size_type	OptimizersListSizeType

typedef std::vector < LocalOptimizerPointer >	OptimizersListType

typedef ObjectToObjectOptimizerBaseTemplate < TInternalComputationValueType >	OptimizerType

typedef Superclass::ParametersType	ParametersType

typedef SmartPointer< Self >	Pointer

typedef MultiGradientOptimizerv4Template	Self

typedef std::ostringstream	StopConditionDescriptionType

typedef std::string	StopConditionReturnStringType

typedef Superclass::StopConditionType	StopConditionType

typedef GradientDescentOptimizerv4Template < TInternalComputationValueType >	Superclass

Public Types inherited from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType >
typedef SmartPointer< const Self >	ConstPointer

typedef itk::Function::WindowConvergenceMonitoringFunction < TInternalComputationValueType >	ConvergenceMonitoringType

typedef Superclass::DerivativeType	DerivativeType

typedef Superclass::IndexRangeType	IndexRangeType

typedef TInternalComputationValueType	InternalComputationValueType

typedef Superclass::MeasureType	MeasureType

typedef Superclass::ParametersType	ParametersType

typedef SmartPointer< Self >	Pointer

typedef Superclass::ScalesType	ScalesType

typedef GradientDescentOptimizerv4Template	Self

typedef Superclass::StopConditionType	StopConditionType

typedef GradientDescentOptimizerBasev4Template < TInternalComputationValueType >	Superclass

Public Types inherited from itk::GradientDescentOptimizerBasev4Template< TInternalComputationValueType >
typedef SmartPointer< const Self >	ConstPointer

typedef MetricType::DerivativeType	DerivativeType

typedef ThreadedIndexedContainerPartitioner::IndexRangeType	IndexRangeType

typedef TInternalComputationValueType	InternalComputationValueType

typedef Superclass::MeasureType	MeasureType

typedef Superclass::MetricType	MetricType

typedef MetricType::Pointer	MetricTypePointer

typedef Superclass::ParametersType	ParametersType

typedef SmartPointer< Self >	Pointer

typedef Superclass::ScalesType	ScalesType

typedef GradientDescentOptimizerBasev4Template	Self

typedef std::ostringstream	StopConditionDescriptionType

typedef std::string	StopConditionReturnStringType

enum	StopConditionType { MAXIMUM_NUMBER_OF_ITERATIONS, COSTFUNCTION_ERROR, UPDATE_PARAMETERS_ERROR, STEP_TOO_SMALL, CONVERGENCE_CHECKER_PASSED, OTHER_ERROR }

typedef ObjectToObjectOptimizerBaseTemplate < TInternalComputationValueType >	Superclass

Public Types inherited from itk::ObjectToObjectOptimizerBaseTemplate< TInternalComputationValueType >
typedef SmartPointer< const Self >	ConstPointer

typedef MetricType::MeasureType	MeasureType

typedef ObjectToObjectMetricBaseTemplate < TInternalComputationValueType >	MetricType

typedef MetricType::Pointer	MetricTypePointer

typedef MetricType::NumberOfParametersType	NumberOfParametersType

typedef OptimizerParameters < TInternalComputationValueType >	ParametersType

typedef SmartPointer< Self >	Pointer

typedef OptimizerParameters < TInternalComputationValueType >	ScalesType

typedef ObjectToObjectOptimizerBaseTemplate	Self

typedef Object	Superclass

Public Types inherited from itk::Object
typedef SmartPointer< const Self >	ConstPointer

typedef SmartPointer< Self >	Pointer

typedef Object	Self

typedef LightObject	Superclass

Public Types inherited from itk::LightObject
typedef SmartPointer< const Self >	ConstPointer

typedef SmartPointer< Self >	Pointer

typedef LightObject	Self

Public Member Functions
virtual ::itk::LightObject::Pointer	CreateAnother (void) const

virtual SizeValueType	GetCurrentIteration () const

const MetricValuesListType &	GetMetricValuesList () const

virtual const char *	GetNameOfClass () const

virtual const SizeValueType &	GetNumberOfIterations ()

OptimizersListType &	GetOptimizersList ()

virtual const StopConditionType &	GetStopCondition ()

virtual const StopConditionReturnStringType	GetStopConditionDescription () const

virtual void	ResumeOptimization ()

virtual void	SetNumberOfIterations (SizeValueType _arg)

void	SetOptimizersList (OptimizersListType &p)

virtual void	StartOptimization (bool doOnlyInitialization=false)

virtual void	StopOptimization (void)

Public Member Functions inherited from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType >
virtual void	EstimateLearningRate ()

virtual const TInternalComputationValueType &	GetConvergenceValue ()

virtual const TInternalComputationValueType &	GetLearningRate ()

virtual const TInternalComputationValueType &	GetMaximumStepSizeInPhysicalUnits ()

virtual void	SetConvergenceWindowSize (SizeValueType _arg)

virtual void	SetLearningRate (TInternalComputationValueType _arg)

virtual void	SetMaximumStepSizeInPhysicalUnits (TInternalComputationValueType _arg)

virtual void	SetMinimumConvergenceValue (TInternalComputationValueType _arg)

virtual void	SetScalesEstimator (OptimizerParameterScalesEstimatorTemplate< TInternalComputationValueType > *_arg)

virtual void	SetDoEstimateScales (bool _arg)

virtual const bool &	GetDoEstimateScales ()

virtual void	DoEstimateScalesOn ()

virtual void	DoEstimateScalesOff ()

virtual void	SetDoEstimateLearningRateAtEachIteration (bool _arg)

virtual const bool &	GetDoEstimateLearningRateAtEachIteration ()

virtual void	DoEstimateLearningRateAtEachIterationOn ()

virtual void	DoEstimateLearningRateAtEachIterationOff ()

virtual void	SetDoEstimateLearningRateOnce (bool _arg)

virtual const bool &	GetDoEstimateLearningRateOnce ()

virtual void	DoEstimateLearningRateOnceOn ()

virtual void	DoEstimateLearningRateOnceOff ()

virtual void	SetReturnBestParametersAndValue (bool _arg)

virtual const bool &	GetReturnBestParametersAndValue ()

virtual void	ReturnBestParametersAndValueOn ()

virtual void	ReturnBestParametersAndValueOff ()

Public Member Functions inherited from itk::GradientDescentOptimizerBasev4Template< TInternalComputationValueType >
virtual const DerivativeType &	GetGradient ()

virtual void	ModifyGradientByScales ()

virtual void	ModifyGradientByLearningRate ()

Public Member Functions inherited from itk::ObjectToObjectOptimizerBaseTemplate< TInternalComputationValueType >
virtual const MeasureType &	GetCurrentMetricValue ()

virtual const ParametersType &	GetCurrentPosition () const

virtual const ThreadIdType &	GetNumberOfThreads ()

virtual const ScalesType &	GetScales ()

virtual const bool &	GetScalesAreIdentity ()

virtual const MeasureType &	GetValue () const

virtual const ScalesType &	GetWeights ()

virtual const bool &	GetWeightsAreIdentity ()

virtual void	SetNumberOfThreads (ThreadIdType number)

virtual void	SetScales (ScalesType _arg)

virtual void	SetWeights (ScalesType _arg)

virtual void	SetMetric (MetricType *_arg)

virtual MetricType *	GetModifiableMetric ()

virtual const MetricType *	GetMetric () const

Public Member Functions inherited from itk::Object
unsigned long	AddObserver (const EventObject &event, Command *)

unsigned long	AddObserver (const EventObject &event, Command *) const

virtual void	DebugOff () const

virtual void	DebugOn () const

Command *	GetCommand (unsigned long tag)

bool	GetDebug () const

MetaDataDictionary &	GetMetaDataDictionary (void)

const MetaDataDictionary &	GetMetaDataDictionary (void) const

virtual ModifiedTimeType	GetMTime () const

virtual const TimeStamp &	GetTimeStamp () const

bool	HasObserver (const EventObject &event) const

void	InvokeEvent (const EventObject &)

void	InvokeEvent (const EventObject &) const

virtual void	Modified () const

virtual void	Register () const

void	RemoveAllObservers ()

void	RemoveObserver (unsigned long tag)

void	SetDebug (bool debugFlag) const

void	SetMetaDataDictionary (const MetaDataDictionary &rhs)

virtual void	SetReferenceCount (int)

virtual void	UnRegister () const

virtual void	SetObjectName (std::string _arg)

virtual const std::string &	GetObjectName ()

Public Member Functions inherited from itk::LightObject
virtual void	Delete ()

virtual int	GetReferenceCount () const

	itkCloneMacro (Self)

void	Print (std::ostream &os, Indent indent=0) const

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 flag)

Static Public Member Functions inherited from itk::LightObject
static void	BreakOnError ()

static Pointer	New ()

Protected Member Functions
virtual void	PrintSelf (std::ostream &os, Indent indent) const


	MultiGradientOptimizerv4Template ()

virtual	~MultiGradientOptimizerv4Template ()

Protected Member Functions inherited from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType >
virtual void	AdvanceOneStep (void)

	GradientDescentOptimizerv4Template ()

virtual	~GradientDescentOptimizerv4Template ()

virtual void	ModifyGradientByScalesOverSubRange (const IndexRangeType &subrange)

virtual void	ModifyGradientByLearningRateOverSubRange (const IndexRangeType &subrange)

Protected Member Functions inherited from itk::GradientDescentOptimizerBasev4Template< TInternalComputationValueType >
	GradientDescentOptimizerBasev4Template ()

virtual	~GradientDescentOptimizerBasev4Template ()

Protected Member Functions inherited from itk::ObjectToObjectOptimizerBaseTemplate< TInternalComputationValueType >
	ObjectToObjectOptimizerBaseTemplate ()

virtual	~ObjectToObjectOptimizerBaseTemplate ()

Protected Member Functions inherited from itk::Object
	Object ()

bool	PrintObservers (std::ostream &os, Indent indent) const

virtual void	SetTimeStamp (const TimeStamp &time)

virtual	~Object ()

Protected Member Functions inherited from itk::LightObject
virtual LightObject::Pointer	InternalClone () const

	LightObject ()

virtual void	PrintHeader (std::ostream &os, Indent indent) const

virtual void	PrintTrailer (std::ostream &os, Indent indent) const

virtual	~LightObject ()

Protected Attributes
SizeValueType	m_CurrentIteration

MeasureType	m_MaximumMetricValue

MetricValuesListType	m_MetricValuesList

MeasureType	m_MinimumMetricValue

SizeValueType	m_NumberOfIterations

OptimizersListType	m_OptimizersList

bool	m_Stop

StopConditionType	m_StopCondition

StopConditionDescriptionType	m_StopConditionDescription

Protected Attributes inherited from itk::GradientDescentOptimizerv4Template< TInternalComputationValueType >
ParametersType	m_BestParameters

ConvergenceMonitoringType::Pointer	m_ConvergenceMonitoring

TInternalComputationValueType	m_ConvergenceValue

SizeValueType	m_ConvergenceWindowSize

MeasureType	m_CurrentBestValue

TInternalComputationValueType	m_LearningRate

TInternalComputationValueType	m_MaximumStepSizeInPhysicalUnits

TInternalComputationValueType	m_MinimumConvergenceValue

bool	m_ReturnBestParametersAndValue

OptimizerParameterScalesEstimatorTemplate < TInternalComputationValueType > ::Pointer	m_ScalesEstimator

Protected Attributes inherited from itk::GradientDescentOptimizerBasev4Template< TInternalComputationValueType >
SizeValueType	m_CurrentIteration

DerivativeType	m_Gradient

DomainThreader < ThreadedIndexedContainerPartitioner, Self >::Pointer	m_ModifyGradientByLearningRateThreader

DomainThreader < ThreadedIndexedContainerPartitioner, Self >::Pointer	m_ModifyGradientByScalesThreader

SizeValueType	m_NumberOfIterations

bool	m_Stop

StopConditionType	m_StopCondition

StopConditionDescriptionType	m_StopConditionDescription

Protected Attributes inherited from itk::ObjectToObjectOptimizerBaseTemplate< TInternalComputationValueType >
MeasureType	m_CurrentMetricValue

MetricTypePointer	m_Metric

ThreadIdType	m_NumberOfThreads

ScalesType	m_Scales

bool	m_ScalesAreIdentity

ScalesType	m_Weights

bool	m_WeightsAreIdentity

Protected Attributes inherited from itk::LightObject
InternalReferenceCountType	m_ReferenceCount

SimpleFastMutexLock	m_ReferenceCountLock

Private Member Functions
	MultiGradientOptimizerv4Template (const Self &)

void	operator= (const Self &)

Additional Inherited Members
Protected Types inherited from itk::LightObject
typedef int	InternalReferenceCountType