Main Page   Groups   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Concepts

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

#include <itkConfidenceConnectedImageFilter.h>

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

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

Collaboration graph
[legend]
List of all members.

Public Types

typedef ConfidenceConnectedImageFilter Self
typedef ImageToImageFilter<
TInputImage, TOutputImage > 
Superclass
typedef SmartPointer< SelfPointer
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< IndexTypeSeedsContainerType
typedef NumericTraits< InputImagePixelType
>::RealType 
InputRealType

Public Member Functions

virtual const char * GetNameOfClass () const
void PrintSelf (std::ostream &os, Indent indent) const
virtual const InputRealTypeGetMean ()
virtual const InputRealTypeGetVariance ()
void SetSeed (const IndexType &seed)
void ClearSeeds ()
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 155 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 113 of file itkConfidenceConnectedImageFilter.h.

template<class TInputImage, class TOutputImage>
void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::ClearSeeds  )  [inline]
 

Clear all the seeds.

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 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 const char* itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetNameOfClass  )  const [virtual]
 

Run-time type information (and related methods).

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

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:
Generated at Thu May 25 00:38:52 2006 for ITK by doxygen 1.3.5 written by Dimitri van Heesch, © 1997-2000