#include <itkMultiGradientOptimizerv4.h>

Inheritance diagram for itk::MultiGradientOptimizerv4:

Collaboration diagram for itk::MultiGradientOptimizerv4:

Public Types
typedef SmartPointer< const Self >	ConstPointer
typedef MetricType::DerivativeType	DerivativeType
typedef Superclass::InternalComputationValueType	InternalComputationValueType
typedef itk::GradientDescentOptimizerv4::Pointer	LocalOptimizerPointer
typedef itk::GradientDescentOptimizerv4	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 ObjectToObjectOptimizerBase	OptimizerType
typedef Superclass::ParametersType	ParametersType
typedef SmartPointer< Self >	Pointer
typedef MultiGradientOptimizerv4	Self
typedef std::ostringstream	StopConditionDescriptionType
typedef std::string	StopConditionReturnStringType
typedef GradientDescentOptimizerv4	Superclass
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 (void)
virtual void	StopOptimization (void)
Static Public Member Functions
static Pointer	New ()
Protected Member Functions
virtual void	PrintSelf (std::ostream &os, Indent indent) const

	MultiGradientOptimizerv4 ()
virtual	~MultiGradientOptimizerv4 ()
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
Private Member Functions
	MultiGradientOptimizerv4 (const Self &)
void	operator= (const Self &)

Detailed Description

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

The test for this class illustrates the expected behavior.

Definition at line 42 of file itkMultiGradientOptimizerv4.h.

Member Typedef Documentation

typedef SmartPointer< const Self > itk::MultiGradientOptimizerv4::ConstPointer

Reimplemented from itk::GradientDescentOptimizerv4.

Definition at line 50 of file itkMultiGradientOptimizerv4.h.

typedef MetricType::DerivativeType itk::MultiGradientOptimizerv4::DerivativeType

Derivative type

Reimplemented from itk::GradientDescentOptimizerv4.

Definition at line 77 of file itkMultiGradientOptimizerv4.h.

typedef Superclass::InternalComputationValueType itk::MultiGradientOptimizerv4::InternalComputationValueType

Internal computation type, for maintaining a desired precision

Reimplemented from itk::GradientDescentOptimizerv4.

Definition at line 84 of file itkMultiGradientOptimizerv4.h.

typedef itk::GradientDescentOptimizerv4::Pointer itk::MultiGradientOptimizerv4::LocalOptimizerPointer

Definition at line 59 of file itkMultiGradientOptimizerv4.h.

typedef itk::GradientDescentOptimizerv4 itk::MultiGradientOptimizerv4::LocalOptimizerType

Definition at line 56 of file itkMultiGradientOptimizerv4.h.

typedef Superclass::MeasureType itk::MultiGradientOptimizerv4::MeasureType

Measure type

Reimplemented from itk::GradientDescentOptimizerv4.

Definition at line 80 of file itkMultiGradientOptimizerv4.h.

typedef Superclass::MetricType itk::MultiGradientOptimizerv4::MetricType

Metric type over which this class is templated

Reimplemented from itk::GradientDescentOptimizerBasev4.

Definition at line 73 of file itkMultiGradientOptimizerv4.h.

typedef MetricType::Pointer itk::MultiGradientOptimizerv4::MetricTypePointer

Reimplemented from itk::GradientDescentOptimizerBasev4.

Definition at line 74 of file itkMultiGradientOptimizerv4.h.

typedef std::vector< MeasureType > itk::MultiGradientOptimizerv4::MetricValuesListType

Definition at line 81 of file itkMultiGradientOptimizerv4.h.

typedef OptimizerType::Pointer itk::MultiGradientOptimizerv4::OptimizerPointer

Definition at line 62 of file itkMultiGradientOptimizerv4.h.

typedef OptimizersListType::size_type itk::MultiGradientOptimizerv4::OptimizersListSizeType

Definition at line 64 of file itkMultiGradientOptimizerv4.h.

typedef std::vector< LocalOptimizerPointer > itk::MultiGradientOptimizerv4::OptimizersListType

Definition at line 63 of file itkMultiGradientOptimizerv4.h.

typedef ObjectToObjectOptimizerBase itk::MultiGradientOptimizerv4::OptimizerType

Definition at line 61 of file itkMultiGradientOptimizerv4.h.

typedef Superclass::ParametersType itk::MultiGradientOptimizerv4::ParametersType

Parameters type.

Reimplemented from itk::ObjectToObjectOptimizerBase.

Definition at line 60 of file itkMultiGradientOptimizerv4.h.

typedef SmartPointer< Self > itk::MultiGradientOptimizerv4::Pointer

Reimplemented from itk::GradientDescentOptimizerv4.

Definition at line 49 of file itkMultiGradientOptimizerv4.h.

typedef MultiGradientOptimizerv4 itk::MultiGradientOptimizerv4::Self

Standard class typedefs.

Reimplemented from itk::GradientDescentOptimizerv4.

Definition at line 47 of file itkMultiGradientOptimizerv4.h.

typedef std::ostringstream itk::MultiGradientOptimizerv4::StopConditionDescriptionType

Stop condition internal string type

Reimplemented from itk::GradientDescentOptimizerBasev4.

Definition at line 70 of file itkMultiGradientOptimizerv4.h.

typedef std::string itk::MultiGradientOptimizerv4::StopConditionReturnStringType

Stop condition return string type

Reimplemented from itk::GradientDescentOptimizerBasev4.

Definition at line 67 of file itkMultiGradientOptimizerv4.h.

typedef GradientDescentOptimizerv4 itk::MultiGradientOptimizerv4::Superclass

Reimplemented from itk::GradientDescentOptimizerv4.

Definition at line 48 of file itkMultiGradientOptimizerv4.h.

Constructor & Destructor Documentation

itk::MultiGradientOptimizerv4::MultiGradientOptimizerv4 ( ) [protected]

Default constructor

virtual itk::MultiGradientOptimizerv4::~MultiGradientOptimizerv4 ( ) [protected, virtual]

Default constructor

itk::MultiGradientOptimizerv4::MultiGradientOptimizerv4 ( const Self & ) [private]

Member Function Documentation

virtual::itk::LightObject::Pointer itk::MultiGradientOptimizerv4::CreateAnother ( void ) const [virtual]

Create an object from an instance, potentially deferring to a factory. This method allows you to create an instance of an object that is exactly the same type as the referring object. This is useful in cases where an object has been cast back to a base class.

Reimplemented from itk::GradientDescentOptimizerv4.

virtual SizeValueType itk::MultiGradientOptimizerv4::GetCurrentIteration ( ) const [virtual]

Get the current iteration number.

Reimplemented from itk::GradientDescentOptimizerBasev4.

const MetricValuesListType& itk::MultiGradientOptimizerv4::GetMetricValuesList ( ) const

Get the list of metric values that we produced after the multi-objective search.

virtual const char* itk::MultiGradientOptimizerv4::GetNameOfClass ( ) const [virtual]

Run-time type information (and related methods).

Reimplemented from itk::GradientDescentOptimizerv4.

virtual const SizeValueType& itk::MultiGradientOptimizerv4::GetNumberOfIterations ( ) [virtual]

Get the number of iterations.

Reimplemented from itk::GradientDescentOptimizerBasev4.

OptimizersListType& itk::MultiGradientOptimizerv4::GetOptimizersList ( )

Get the list of optimizers currently held.

virtual const StopConditionType& itk::MultiGradientOptimizerv4::GetStopCondition ( ) [virtual]

Get stop condition enum

Reimplemented from itk::GradientDescentOptimizerBasev4.

virtual const StopConditionReturnStringType itk::MultiGradientOptimizerv4::GetStopConditionDescription ( ) const [virtual]

Get the reason for termination

Reimplemented from itk::GradientDescentOptimizerBasev4.

static Pointer itk::MultiGradientOptimizerv4::New ( ) [static]

Method for creation through the object factory.

Reimplemented from itk::GradientDescentOptimizerv4.

void itk::MultiGradientOptimizerv4::operator= ( const Self & ) [private]

Mutex lock to protect modification to the reference count

Reimplemented from itk::GradientDescentOptimizerv4.

virtual void itk::MultiGradientOptimizerv4::PrintSelf	(	std::ostream &	os,
		Indent	indent
	)		const `[protected, virtual]`

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::GradientDescentOptimizerv4.

virtual void itk::MultiGradientOptimizerv4::ResumeOptimization ( ) [virtual]

Resume the optimization. Can be called after StopOptimization to resume. The bulk of the optimization work loop is here.

Reimplemented from itk::GradientDescentOptimizerv4.

virtual void itk::MultiGradientOptimizerv4::SetNumberOfIterations ( SizeValueType _arg ) [virtual]

Set the number of iterations.

Reimplemented from itk::GradientDescentOptimizerBasev4.

void itk::MultiGradientOptimizerv4::SetOptimizersList ( OptimizersListType & p )

Set the list of optimizers to combine

virtual void itk::MultiGradientOptimizerv4::StartOptimization ( void ) [virtual]

Begin the optimization

Reimplemented from itk::GradientDescentOptimizerv4.