itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage > Class Template Reference

Threshold an image using robust automatic threshold selection (RATS) method. More...

#include <itkRobustAutomaticThresholdImageFilter.h>

Inheritance diagram for itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >:

Collaboration diagram for itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >:

List of all members.

Public Types
typedef RobustAutomaticThresholdCalculator < TInputImage, TGradientImage >	CalculatorType
typedef SmartPointer< const Self >	ConstPointer
typedef TGradientImage::Pointer	GradientImagePointer
typedef TGradientImage	GradientImageType
typedef TGradientImage::PixelType	GradientPixelType
typedef TInputImage::Pointer	InputImagePointer
typedef TInputImage::RegionType	InputImageRegionType
typedef TInputImage	InputImageType
typedef TInputImage::IndexType	InputIndexType
typedef TInputImage::PixelType	InputPixelType
typedef TInputImage::SizeType	InputSizeType
typedef TOutputImage::Pointer	OutputImagePointer
typedef TOutputImage::RegionType	OutputImageRegionType
typedef TOutputImage::IndexType	OutputIndexType
typedef TOutputImage::PixelType	OutputPixelType
typedef TOutputImage::SizeType	OutputSizeType
typedef SmartPointer< Self >	Pointer
typedef RobustAutomaticThresholdImageFilter	Self
typedef ImageToImageFilter < TInputImage, TOutputImage >	Superclass
Public Member Functions
virtual ::itk::LightObject::Pointer	CreateAnother (void) const
GradientImageType *	GetGradientImage ()
virtual OutputPixelType	GetInsideValue () const
virtual const char *	GetNameOfClass () const
virtual OutputPixelType	GetOutsideValue () const
virtual double	GetPow () const
virtual InputPixelType	GetThreshold () const
void	SetGradientImage (GradientImageType *input)
void	SetInput1 (TInputImage *input)
void	SetInput2 (GradientImageType *input)
virtual void	SetInsideValue (OutputPixelType _arg)
virtual void	SetOutsideValue (OutputPixelType _arg)
virtual void	SetPow (double _arg)
	typedef (Concept::Comparable< OutputPixelType >) OutputComparableCheck
	typedef (Concept::OStreamWritable< OutputPixelType >) OutputOStreamWritableCheck
Static Public Member Functions
static Pointer	New ()
Static Public Attributes
static const unsigned int	InputImageDimension = TInputImage::ImageDimension
static const unsigned int	OutputImageDimension = TOutputImage::ImageDimension
Protected Member Functions
void	GenerateData ()
void	GenerateInputRequestedRegion ()
void	PrintSelf (std::ostream &os, Indent indent) const
	RobustAutomaticThresholdImageFilter ()
	~RobustAutomaticThresholdImageFilter ()
Private Member Functions
void	operator= (const Self &)
	RobustAutomaticThresholdImageFilter (const Self &)
Private Attributes
OutputPixelType	m_InsideValue
OutputPixelType	m_OutsideValue
double	m_Pow
InputPixelType	m_Threshold

---

Detailed Description

template<class TInputImage, class TGradientImage = TInputImage, class TOutputImage = TInputImage>
class itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >

Threshold an image using robust automatic threshold selection (RATS) method.

RobustAutomaticThresholdImageFilter takes two inputs: the image to be thresholded and a image of gradient magnitude of that image. The threshold is computed as the mean of the pixel values in the input image weighted by the pixel values in the gradient image. The threshold computed that way should be the mean pixel value where the intensity change the most.

This code was contributed in the Insight Journal paper: "Robust Automatic Threshold Selection" by Lehmann G. http://hdl.handle.net/1926/370 http://www.insight-journal.org/browse/publication/134

Author:

Gaetan Lehmann. Biologie du Developpement et de la Reproduction, INRA de Jouy-en-Josas, France.

Definition at line 51 of file itkRobustAutomaticThresholdImageFilter.h.

---

Member Typedef Documentation

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef RobustAutomaticThresholdCalculator< TInputImage, TGradientImage > itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::CalculatorType

Definition at line 89 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef SmartPointer< const Self > itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::ConstPointer

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Definition at line 59 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TGradientImage::Pointer itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::GradientImagePointer

Definition at line 79 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TGradientImage itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::GradientImageType

Definition at line 69 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TGradientImage::PixelType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::GradientPixelType

Definition at line 74 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TInputImage::Pointer itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::InputImagePointer

Image related typedefs.

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Definition at line 77 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TInputImage::RegionType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::InputImageRegionType

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Definition at line 83 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TInputImage itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::InputImageType

Standard image type within this class.

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Definition at line 65 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TInputImage::IndexType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::InputIndexType

Definition at line 82 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TInputImage::PixelType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::InputPixelType

Image pixel value typedef.

Definition at line 72 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TInputImage::SizeType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::InputSizeType

Definition at line 81 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TOutputImage::Pointer itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::OutputImagePointer

Reimplemented from itk::ImageSource< TOutputImage >.

Definition at line 78 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TOutputImage::RegionType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::OutputImageRegionType

Superclass typedefs.

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Definition at line 86 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TOutputImage::IndexType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::OutputIndexType

Definition at line 85 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TOutputImage::PixelType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::OutputPixelType

Definition at line 73 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef TOutputImage::SizeType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::OutputSizeType

Definition at line 84 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef SmartPointer< Self > itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::Pointer

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Definition at line 58 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef RobustAutomaticThresholdImageFilter itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::Self

Standard Self typedef

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Definition at line 56 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

typedef ImageToImageFilter< TInputImage, TOutputImage > itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::Superclass

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Definition at line 57 of file itkRobustAutomaticThresholdImageFilter.h.

---

Constructor & Destructor Documentation

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::RobustAutomaticThresholdImageFilter

(

)

[protected]

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::~RobustAutomaticThresholdImageFilter

(

)

[inline, protected]

Definition at line 155 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::RobustAutomaticThresholdImageFilter

(

const Self &

)

[private]

---

Member Function Documentation

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

virtual::itk::LightObject::Pointer itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::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::Object.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

void itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::GenerateData

(

)

[protected, virtual]

A version of GenerateData() specific for image processing filters. This implementation will split the processing across multiple threads. The buffer is allocated by this method. Then the BeforeThreadedGenerateData() method is called (if provided). Then, a series of threads are spawned each calling ThreadedGenerateData(). After all the threads have completed processing, the AfterThreadedGenerateData() method is called (if provided). If an image processing filter cannot be threaded, the filter should provide an implementation of GenerateData(). That implementation is responsible for allocating the output buffer. If a filter an be threaded, it should NOT provide a GenerateData() method but should provide a ThreadedGenerateData() instead.

See also:

ThreadedGenerateData()

Reimplemented from itk::ImageSource< TOutputImage >.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

void itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::GenerateInputRequestedRegion

(

)

[protected, virtual]

What is the input requested region that is required to produce the output requested region? The base assumption for image processing filters is that the input requested region can be set to match the output requested region. If a filter requires more input (for instance a filter that uses neighborhoods needs more input than output to avoid introducing artificial boundary conditions) or less input (for instance a magnify filter) will have to override this method. In doing so, it should call its superclass' implementation as its first step. Note that imaging filters operate differently than the classes to this point in the class hierachy. Up till now, the base assumption has been that the largest possible region will be requested of the input.

This implementation of GenerateInputRequestedRegion() only processes the inputs that are a subclass of the ImageBase<InputImageDimension>. If an input is another type of DataObject (including an Image of a different dimension), they are skipped by this method. The subclasses of ImageToImageFilter are responsible for providing an implementation of GenerateInputRequestedRegion() when there are multiple inputs of different types.

See also:

ProcessObject::GenerateInputRequestedRegion(), ImageSource::GenerateInputRequestedRegion()

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

GradientImageType* itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::GetGradientImage

(

)

[inline]

Get the gradient image

Definition at line 136 of file itkRobustAutomaticThresholdImageFilter.h.

References itk::ProcessObject::GetInput().

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

virtual OutputPixelType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::GetInsideValue

(

)

const [virtual]

Get the "inside" pixel value.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

virtual const char* itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::GetNameOfClass

(

)

const [virtual]

Runtime information support.

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

virtual OutputPixelType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::GetOutsideValue

(

)

const [virtual]

Get the "outside" pixel value.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

virtual double itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::GetPow

(

)

const [virtual]

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

virtual InputPixelType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::GetThreshold

(

)

const [virtual]

Get the computed threshold.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

static Pointer itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::New

(

)

[static]

Method for creation through the object factory.

Reimplemented from itk::Object.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

void itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::operator=

(

const Self &

)

[private]

PushBackInput(), PushFronInput() in the public section force the input to be the type expected by an ImageToImageFilter. However, these methods end of "hiding" the versions from the superclass (ProcessObject) whose arguments are DataObjects. Here, we re-expose the versions from ProcessObject to avoid warnings about hiding methods from the superclass.

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

void itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::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::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

void itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::SetGradientImage

(

GradientImageType *

input

)

[inline]

End concept checking Set the gradient image

Definition at line 129 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

void itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::SetInput1

(

TInputImage *

input

)

[inline]

Set the input image

Definition at line 142 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

void itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::SetInput2

(

GradientImageType *

input

)

[inline]

Set the gradient image

Definition at line 148 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

virtual void itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::SetInsideValue

(

OutputPixelType

_arg

)

[virtual]

Set the "inside" pixel value. The default value NumericTraits<OutputPixelType>::max()

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

virtual void itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::SetOutsideValue

(

OutputPixelType

_arg

)

[virtual]

Set the "outside" pixel value. The default value NumericTraits<OutputPixelType>::Zero.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

virtual void itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::SetPow

(

double

_arg

)

[virtual]

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::typedef

(

Concept::OStreamWritable< OutputPixelType >

)

This class requires OutputOStreamWritableCheck in the form of ( Concept::OStreamWritable< OutputPixelType > )

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::typedef

(

Concept::Comparable< OutputPixelType >

)

Begin concept checking This class requires OutputComparableCheck in the form of ( Concept::Comparable< OutputPixelType > )

---

Member Data Documentation

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

const unsigned int itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::InputImageDimension = TInputImage::ImageDimension [static]

Image related typedefs.

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Definition at line 93 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

OutputPixelType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::m_InsideValue [private]

Definition at line 168 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

OutputPixelType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::m_OutsideValue [private]

Definition at line 169 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

double itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::m_Pow [private]

Definition at line 166 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

InputPixelType itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::m_Threshold [private]

Definition at line 167 of file itkRobustAutomaticThresholdImageFilter.h.

template<class TInputImage , class TGradientImage = TInputImage, class TOutputImage = TInputImage>

const unsigned int itk::RobustAutomaticThresholdImageFilter< TInputImage, TGradientImage, TOutputImage >::OutputImageDimension = TOutputImage::ImageDimension [static]

Image related typedefs.

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Definition at line 95 of file itkRobustAutomaticThresholdImageFilter.h.

---

The documentation for this class was generated from the following file:

• itkRobustAutomaticThresholdImageFilter.h