itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage > Class Template Reference
[Region Growing Filters]

#include <itkConfidenceConnectedImageFilter.h>

Inheritance diagram for itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >:

[legend]Collaboration diagram for itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >:

[legend]List of all members.

Public Types
typedef ConfidenceConnectedImageFilter	Self
typedef ImageToImageFilter< TInputImage, TOutputImage >	Superclass
typedef SmartPointer< Self >	Pointer
typedef SmartPointer< const Self >	ConstPointer
typedef TInputImage	InputImageType
typedef InputImageType::Pointer	InputImagePointer
typedef InputImageType::RegionType	InputImageRegionType
typedef InputImageType::PixelType	InputImagePixelType
typedef InputImageType::IndexType	IndexType
typedef InputImageType::SizeType	SizeType
typedef TOutputImage	OutputImageType
typedef OutputImageType::Pointer	OutputImagePointer
typedef OutputImageType::RegionType	OutputImageRegionType
typedef OutputImageType::PixelType	OutputImagePixelType
typedef std::vector< IndexType >	SeedsContainerType
typedef NumericTraits< InputImagePixelType >::RealType	InputRealType
Public Member Functions
virtual const char *	GetClassName () const
void	PrintSelf (std::ostream &os, Indent indent) const
virtual const InputRealType &	GetMean ()
virtual const InputRealType &	GetVariance ()
void	SetSeed (const IndexType &seed)
void	AddSeed (const IndexType &seed)
virtual void	SetMultiplier (double _arg)
virtual double	GetMultiplier ()
virtual void	SetNumberOfIterations (unsigned int _arg)
virtual unsigned int	GetNumberOfIterations ()
virtual void	SetReplaceValue (OutputImagePixelType _arg)
virtual OutputImagePixelType	GetReplaceValue ()
virtual void	SetInitialNeighborhoodRadius (unsigned int _arg)
virtual const unsigned int &	GetInitialNeighborhoodRadius ()
Static Public Member Functions
Pointer	New ()
Protected Member Functions
	ConfidenceConnectedImageFilter ()
	~ConfidenceConnectedImageFilter ()
void	GenerateInputRequestedRegion ()
void	EnlargeOutputRequestedRegion (DataObject *output)
void	GenerateData ()

---

Detailed Description

template<class TInputImage, class TOutputImage>
class itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >

/class ConfidenceConnectedImageFilter /brief Segment pixels with similar statistics using connectivity

This filter extracts a connected set of pixels whose pixel intensities are consistent with the pixel statistics of a seed point. The mean and variance across a neighborhood (8-connected, 26-connected, etc.) are calculated for a seed point. Then pixels connected to this seed point whose values are within the confidence interval for the seed point are grouped. The width of the confidence interval is controlled by the "Multiplier" variable (the confidence interval is the mean plus or minus the "Multiplier" times the standard deviation). If the intensity variations across a segment were gaussian, a "Multiplier" setting of 2.5 would define a confidence interval wide enough to capture 99% of samples in the segment.

After this initial segmentation is calculated, the mean and variance are re-calculated. All the pixels in the previous segmentation are used to calculate the mean the standard deviation (as opposed to using the pixels in the neighborhood of the seed point). The segmentation is then recalculted using these refined estimates for the mean and variance of the pixel values. This process is repeated for the specified number of iterations. Setting the "NumberOfIterations" to zero stops the algorithm after the initial segmentation from the seed point.

NOTE: the lower and upper threshold are restricted to lie within the valid numeric limits of the input data pixel type. Also, the limits may be adjusted to contain the seed point's intensity.

Definition at line 57 of file itkConfidenceConnectedImageFilter.h.

---

Member Typedef Documentation

template<class TInputImage, class TOutputImage> typedef SmartPointer<const Self> itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::ConstPointer

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 66 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> typedef InputImageType::IndexType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::IndexType

Definition at line 79 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> typedef InputImageType::PixelType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::InputImagePixelType

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 78 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> typedef InputImageType::Pointer itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::InputImagePointer

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 76 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> typedef InputImageType::RegionType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::InputImageRegionType

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 77 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> typedef TInputImage itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::InputImageType

Some convenient typedefs. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 75 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> typedef NumericTraits< InputImagePixelType >::RealType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::InputRealType

Definition at line 90 of file itkConfidenceConnectedImageFilter.h. Referenced by itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::~ConfidenceConnectedImageFilter().

template<class TInputImage, class TOutputImage> typedef OutputImageType::PixelType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::OutputImagePixelType

Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 85 of file itkConfidenceConnectedImageFilter.h. Referenced by itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::~ConfidenceConnectedImageFilter().

template<class TInputImage, class TOutputImage> typedef OutputImageType::Pointer itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::OutputImagePointer

Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 83 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> typedef OutputImageType::RegionType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::OutputImageRegionType

Superclass typedefs. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 84 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> typedef TOutputImage itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::OutputImageType

Some convenient typedefs. Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 82 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> typedef SmartPointer<Self> itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::Pointer

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 65 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> typedef std::vector< IndexType > itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SeedsContainerType

Definition at line 87 of file itkConfidenceConnectedImageFilter.h. Referenced by itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::~ConfidenceConnectedImageFilter().

template<class TInputImage, class TOutputImage> typedef ConfidenceConnectedImageFilter itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::Self

Standard class typedefs. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 63 of file itkConfidenceConnectedImageFilter.h. Referenced by itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::~ConfidenceConnectedImageFilter().

template<class TInputImage, class TOutputImage> typedef InputImageType::SizeType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SizeType

Definition at line 80 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> typedef ImageToImageFilter<TInputImage,TOutputImage> itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::Superclass

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 64 of file itkConfidenceConnectedImageFilter.h.

---

Constructor & Destructor Documentation

template<class TInputImage, class TOutputImage> itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::ConfidenceConnectedImageFilter (   )  [protected]

template<class TInputImage, class TOutputImage> itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::~ConfidenceConnectedImageFilter (   )  [inline, protected]

Definition at line 147 of file itkConfidenceConnectedImageFilter.h. References itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::InputRealType, itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::OutputImagePixelType, itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SeedsContainerType, and itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::Self.

---

Member Function Documentation

template<class TInputImage, class TOutputImage> void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::AddSeed (  const IndexType &  seed  )  [inline]

Add seed point. Definition at line 105 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage> void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::EnlargeOutputRequestedRegion (  DataObject *  output  )  [protected, virtual]

Give the process object a chance to indictate that it will produce more output than it was requested to produce. For example, many imaging filters must compute the entire output at once or can only produce output in complete slices. Such filters cannot handle smaller requested regions. These filters must provide an implementation of this method, setting the output requested region to the size they will produce. By default, a process object does not modify the size of the output requested region. Reimplemented from itk::ProcessObject.

template<class TInputImage, class TOutputImage> void itk::ConfidenceConnectedImageFilter< TInputImage, 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 TOutputImage> void itk::ConfidenceConnectedImageFilter< TInputImage, 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 TOutputImage> virtual const char* itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetClassName (   )  const [virtual]

Run-time type information (and related methods). Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage> virtual const unsigned int& itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetInitialNeighborhoodRadius (   )  [virtual]

Get/Set the radius of the neighborhood over which the statistics are evaluated

template<class TInputImage, class TOutputImage> virtual const InputRealType& itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetMean (   )  [virtual]

Method to get access to the mean of the pixels accepted in the output region. This method should only be invoked after the filter has been executed using the Update() method.

template<class TInputImage, class TOutputImage> virtual double itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetMultiplier (   )  [virtual]

Set/Get the multiplier to define the confidence interval. Multiplier can be anything greater than zero. A typical value is 2.5

template<class TInputImage, class TOutputImage> virtual unsigned int itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetNumberOfIterations (   )  [virtual]

Set/Get the number of iterations

template<class TInputImage, class TOutputImage> virtual OutputImagePixelType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetReplaceValue (   )  [virtual]

Set/Get value to replace thresholded pixels

template<class TInputImage, class TOutputImage> virtual const InputRealType& itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetVariance (   )  [virtual]

Method to get access to the variance of the pixels accepted in the output region. This method should only be invoked after the filter has been executed using the Update() method.

template<class TInputImage, class TOutputImage> Pointer itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::New (   )  [static]

Method for creation through the object factory. Reimplemented from itk::Object.

template<class TInputImage, class TOutputImage> void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::PrintSelf (  std::ostream &  os, Indent  indent )  const [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 TOutputImage> virtual void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SetInitialNeighborhoodRadius (  unsigned int  _arg  )  [virtual]

Get/Set the radius of the neighborhood over which the statistics are evaluated

template<class TInputImage, class TOutputImage> virtual void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SetMultiplier (  double  _arg  )  [virtual]

Set/Get the multiplier to define the confidence interval. Multiplier can be anything greater than zero. A typical value is 2.5

template<class TInputImage, class TOutputImage> virtual void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SetNumberOfIterations (  unsigned int  _arg  )  [virtual]

Set/Get the number of iterations

template<class TInputImage, class TOutputImage> virtual void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SetReplaceValue (  OutputImagePixelType  _arg  )  [virtual]

Set/Get value to replace thresholded pixels

template<class TInputImage, class TOutputImage> void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SetSeed (  const IndexType &  seed  )  [inline]

Set seed point. This method is deprecated, please use AddSeed() Definition at line 96 of file itkConfidenceConnectedImageFilter.h.

---

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

• itkConfidenceConnectedImageFilter.h

---