ITK  4.0.0
Insight Segmentation and Registration Toolkit
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes
itk::LabelVotingImageFilter< TInputImage, TOutputImage > Class Template Reference

This filter performs pixelwise voting among an arbitrary number of input images, where each of them represents a segmentation of the same scene (i.e., image). More...

#include <itkLabelVotingImageFilter.h>

Inheritance diagram for itk::LabelVotingImageFilter< TInputImage, TOutputImage >:
Collaboration diagram for itk::LabelVotingImageFilter< TInputImage, TOutputImage >:

List of all members.

Public Types

typedef SmartPointer< const SelfConstPointer
typedef
InputImageType::ConstPointer 
InputImagePointer
typedef TInputImage InputImageType
typedef TInputImage::PixelType InputPixelType
typedef OutputImageType::Pointer OutputImagePointer
typedef
Superclass::OutputImageRegionType 
OutputImageRegionType
typedef TOutputImage OutputImageType
typedef TOutputImage::PixelType OutputPixelType
typedef SmartPointer< SelfPointer
typedef LabelVotingImageFilter Self
typedef ImageToImageFilter
< TInputImage, TOutputImage > 
Superclass

Public Member Functions

virtual ::itk::LightObject::Pointer CreateAnother (void) const
OutputPixelType GetLabelForUndecidedPixels () const
virtual const char * GetNameOfClass () const
 typedef (Concept::AdditiveOperators< InputPixelType, int >) InputPlusIntCheck
 typedef (Concept::Convertible< int, OutputPixelType >) IntConvertibleToOutputPixelType
 typedef (Concept::Convertible< InputPixelType, unsigned int >) InputConvertibleToUnsignedIntCheck
 typedef (Concept::SameDimension< InputImageDimension, ImageDimension >) SameDimensionCheck
 typedef (Concept::Convertible< int, InputPixelType >) IntConvertibleToInputCheck
 typedef (Concept::Convertible< InputPixelType, OutputPixelType >) InputConvertibleToOutputCheck
 typedef (Concept::OStreamWritable< OutputPixelType >) OutputOStreamWritableCheck
 typedef (Concept::IncrementDecrementOperators< InputPixelType >) InputIncrementDecrementOperatorsCheck
void SetLabelForUndecidedPixels (const OutputPixelType l)
void UnsetLabelForUndecidedPixels ()

Static Public Member Functions

static Pointer New ()

Static Public Attributes

static const unsigned int InputImageDimension = TInputImage::ImageDimension
static const unsigned int ImageDimension = TOutputImage::ImageDimension

Protected Member Functions

void BeforeThreadedGenerateData ()
InputPixelType ComputeMaximumInputValue ()
void PrintSelf (std::ostream &, Indent) const
void ThreadedGenerateData (const OutputImageRegionType &outputRegionForThread, ThreadIdType threadId)
 LabelVotingImageFilter ()
virtual ~LabelVotingImageFilter ()

Private Member Functions

 LabelVotingImageFilter (const Self &)
void operator= (const Self &)

Private Attributes

bool m_HasLabelForUndecidedPixels
OutputPixelType m_LabelForUndecidedPixels
InputPixelType m_TotalLabelCount

Detailed Description

template<typename TInputImage, typename TOutputImage = TInputImage>
class itk::LabelVotingImageFilter< TInputImage, TOutputImage >

This filter performs pixelwise voting among an arbitrary number of input images, where each of them represents a segmentation of the same scene (i.e., image).

Label voting is a simple method of classifier combination applied to image segmentation. Typically, the accuracy of the combined segmentation exceeds the accuracy of any of the input segmentations. Voting is therefore commonly used as a way of boosting segmentation performance.

The use of label voting for combination of multiple segmentations is described in

T. Rohlfing and C. R. Maurer, Jr., "Multi-classifier framework for atlas-based image segmentation," Pattern Recognition Letters, 2005.

INPUTS
All input volumes to this filter must be segmentations of an image, that is, they must have discrete pixel values where each value represents a different segmented object.

Input volumes must all contain the same size RequestedRegions. Not all input images must contain all possible labels, but all label values must have the same meaning in all images.

OUTPUTS
The voting filter produces a single output volume. Each output pixel contains the label that occured most often among the labels assigned to this pixel in all the input volumes, that is, the label that received the maximum number of "votes" from the input pixels.. If the maximum number of votes is not unique, i.e., if more than one label have a maximum number of votes, an "undecided" label is assigned to that output pixel.

By default, the label used for undecided pixels is the maximum label value used in the input images plus one. Since it is possible for an image with 8 bit pixel values to use all 256 possible label values, it is permissible to combine 8 bit (i.e., byte) images into a 16 bit (i.e., short) output image.

PARAMETERS
The label used for "undecided" labels can be set using SetLabelForUndecidedPixels. This functionality can be unset by calling UnsetLabelForUndecidedPixels.
Author:
Torsten Rohlfing, SRI International, Neuroscience Program

Definition at line 75 of file itkLabelVotingImageFilter.h.


Member Typedef Documentation

template<typename TInputImage , typename TOutputImage = TInputImage>
typedef SmartPointer< const Self > itk::LabelVotingImageFilter< TInputImage, TOutputImage >::ConstPointer
template<typename TInputImage , typename TOutputImage = TInputImage>
typedef InputImageType::ConstPointer itk::LabelVotingImageFilter< TInputImage, TOutputImage >::InputImagePointer
template<typename TInputImage , typename TOutputImage = TInputImage>
typedef TInputImage itk::LabelVotingImageFilter< TInputImage, TOutputImage >::InputImageType

Image typedef support

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

Definition at line 105 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
typedef TInputImage::PixelType itk::LabelVotingImageFilter< TInputImage, TOutputImage >::InputPixelType

Definition at line 94 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
typedef OutputImageType::Pointer itk::LabelVotingImageFilter< TInputImage, TOutputImage >::OutputImagePointer

Reimplemented from itk::ImageSource< TOutputImage >.

Definition at line 108 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
typedef Superclass::OutputImageRegionType itk::LabelVotingImageFilter< TInputImage, TOutputImage >::OutputImageRegionType

Superclass typedefs.

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

Definition at line 111 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
typedef TOutputImage itk::LabelVotingImageFilter< TInputImage, TOutputImage >::OutputImageType

Some convenient typedefs.

Reimplemented from itk::ImageSource< TOutputImage >.

Definition at line 106 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
typedef TOutputImage::PixelType itk::LabelVotingImageFilter< TInputImage, TOutputImage >::OutputPixelType

Extract some information from the image types. Dimensionality of the two images is assumed to be the same.

Definition at line 89 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
typedef SmartPointer< Self > itk::LabelVotingImageFilter< TInputImage, TOutputImage >::Pointer
template<typename TInputImage , typename TOutputImage = TInputImage>
typedef LabelVotingImageFilter itk::LabelVotingImageFilter< TInputImage, TOutputImage >::Self

Standard class typedefs.

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

Definition at line 80 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
typedef ImageToImageFilter< TInputImage, TOutputImage > itk::LabelVotingImageFilter< TInputImage, TOutputImage >::Superclass

Constructor & Destructor Documentation

template<typename TInputImage , typename TOutputImage = TInputImage>
itk::LabelVotingImageFilter< TInputImage, TOutputImage >::LabelVotingImageFilter ( ) [inline, protected]

End concept checking

Definition at line 168 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
virtual itk::LabelVotingImageFilter< TInputImage, TOutputImage >::~LabelVotingImageFilter ( ) [inline, protected, virtual]

End concept checking

Definition at line 169 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
itk::LabelVotingImageFilter< TInputImage, TOutputImage >::LabelVotingImageFilter ( const Self ) [private]

Member Function Documentation

template<typename TInputImage , typename TOutputImage = TInputImage>
void itk::LabelVotingImageFilter< TInputImage, TOutputImage >::BeforeThreadedGenerateData ( ) [protected, virtual]

Determine maximum label value in all input images and initialize global data.

Reimplemented from itk::ImageSource< TOutputImage >.

template<typename TInputImage , typename TOutputImage = TInputImage>
InputPixelType itk::LabelVotingImageFilter< TInputImage, TOutputImage >::ComputeMaximumInputValue ( ) [protected]

Determine maximum value among all input images' pixels

template<typename TInputImage , typename TOutputImage = TInputImage>
virtual::itk::LightObject::Pointer itk::LabelVotingImageFilter< TInputImage, 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<typename TInputImage , typename TOutputImage = TInputImage>
OutputPixelType itk::LabelVotingImageFilter< TInputImage, TOutputImage >::GetLabelForUndecidedPixels ( ) const [inline]

Get label value used for undecided pixels. After updating the filter, this function returns the actual label value used for undecided pixels in the current output. Note that this value is overwritten when SetLabelForUndecidedPixels is called and the new value only becomes effective upon the next filter update.

Definition at line 129 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
virtual const char* itk::LabelVotingImageFilter< TInputImage, TOutputImage >::GetNameOfClass ( ) const [virtual]

Run-time type information (and related methods)

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

template<typename TInputImage , typename TOutputImage = TInputImage>
static Pointer itk::LabelVotingImageFilter< TInputImage, TOutputImage >::New ( ) [static]

Method for creation through the object factory.

Reimplemented from itk::Object.

template<typename TInputImage , typename TOutputImage = TInputImage>
void itk::LabelVotingImageFilter< TInputImage, 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<typename TInputImage , typename TOutputImage = TInputImage>
void itk::LabelVotingImageFilter< TInputImage, 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<typename TInputImage , typename TOutputImage = TInputImage>
void itk::LabelVotingImageFilter< TInputImage, TOutputImage >::SetLabelForUndecidedPixels ( const OutputPixelType  l) [inline]

Set label value for undecided pixels.

Definition at line 115 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
void itk::LabelVotingImageFilter< TInputImage, TOutputImage >::ThreadedGenerateData ( const OutputImageRegionType outputRegionForThread,
ThreadIdType  threadId 
) [protected, virtual]

If an imaging filter can be implemented as a multithreaded algorithm, the filter will provide an implementation of ThreadedGenerateData(). This superclass will automatically split the output image into a number of pieces, spawn multiple threads, and call ThreadedGenerateData() in each thread. Prior to spawning threads, the BeforeThreadedGenerateData() method is called. After all the threads have completed, the AfterThreadedGenerateData() method is called. If an image processing filter cannot support threading, that filter should provide an implementation of the GenerateData() method instead of providing an implementation of ThreadedGenerateData(). If a filter provides a GenerateData() method as its implementation, then the filter is responsible for allocating the output data. If a filter provides a ThreadedGenerateData() method as its implementation, then the output memory will allocated automatically by this superclass. The ThreadedGenerateData() method should only produce the output specified by "outputThreadRegion" parameter. ThreadedGenerateData() cannot write to any other portion of the output image (as this is responsibility of a different thread).

See also:
GenerateData(), SplitRequestedRegion()

Reimplemented from itk::ImageSource< TOutputImage >.

template<typename TInputImage , typename TOutputImage = TInputImage>
itk::LabelVotingImageFilter< TInputImage, TOutputImage >::typedef ( Concept::Convertible< int, OutputPixelType )

This class requires IntConvertibleToOutputPixelType in the form of ( Concept::Convertible< int, OutputPixelType > )

template<typename TInputImage , typename TOutputImage = TInputImage>
itk::LabelVotingImageFilter< TInputImage, TOutputImage >::typedef ( Concept::Convertible< InputPixelType, OutputPixelType )

Begin concept checking This class requires InputConvertibleToOutputCheck in the form of ( Concept::Convertible< InputPixelType, OutputPixelType > )

template<typename TInputImage , typename TOutputImage = TInputImage>
itk::LabelVotingImageFilter< TInputImage, TOutputImage >::typedef ( Concept::IncrementDecrementOperators< InputPixelType )

This class requires InputIncrementDecrementOperatorsCheck in the form of ( Concept::IncrementDecrementOperators< InputPixelType > )

template<typename TInputImage , typename TOutputImage = TInputImage>
itk::LabelVotingImageFilter< TInputImage, TOutputImage >::typedef ( Concept::SameDimension< InputImageDimension, ImageDimension )

This class requires SameDimensionCheck in the form of ( Concept::SameDimension< InputImageDimension, ImageDimension > )

template<typename TInputImage , typename TOutputImage = TInputImage>
itk::LabelVotingImageFilter< TInputImage, TOutputImage >::typedef ( Concept::AdditiveOperators< InputPixelType, int >  )

This class requires InputPlusIntCheck in the form of ( Concept::AdditiveOperators< InputPixelType, int > )

template<typename TInputImage , typename TOutputImage = TInputImage>
itk::LabelVotingImageFilter< TInputImage, TOutputImage >::typedef ( Concept::Convertible< InputPixelType, unsigned int >  )

This class requires InputConvertibleToUnsignedIntCheck in the form of ( Concept::Convertible< InputPixelType, unsigned int > )

template<typename TInputImage , typename TOutputImage = TInputImage>
itk::LabelVotingImageFilter< TInputImage, TOutputImage >::typedef ( Concept::OStreamWritable< OutputPixelType )

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

template<typename TInputImage , typename TOutputImage = TInputImage>
itk::LabelVotingImageFilter< TInputImage, TOutputImage >::typedef ( Concept::Convertible< int, InputPixelType )

This class requires IntConvertibleToInputCheck in the form of ( Concept::Convertible< int, InputPixelType > )

template<typename TInputImage , typename TOutputImage = TInputImage>
void itk::LabelVotingImageFilter< TInputImage, TOutputImage >::UnsetLabelForUndecidedPixels ( ) [inline]

Unset label value for undecided pixels and turn on automatic selection.

Definition at line 136 of file itkLabelVotingImageFilter.h.


Member Data Documentation

template<typename TInputImage , typename TOutputImage = TInputImage>
const unsigned int itk::LabelVotingImageFilter< TInputImage, TOutputImage >::ImageDimension = TOutputImage::ImageDimension [static]

Extract some information from the image types. Dimensionality of the two images is assumed to be the same.

Definition at line 101 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
const unsigned int itk::LabelVotingImageFilter< TInputImage, TOutputImage >::InputImageDimension = TInputImage::ImageDimension [static]

Extract some information from the image types. Dimensionality of the two images is assumed to be the same.

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

Definition at line 99 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
bool itk::LabelVotingImageFilter< TInputImage, TOutputImage >::m_HasLabelForUndecidedPixels [private]

Definition at line 189 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
OutputPixelType itk::LabelVotingImageFilter< TInputImage, TOutputImage >::m_LabelForUndecidedPixels [private]

Definition at line 188 of file itkLabelVotingImageFilter.h.

template<typename TInputImage , typename TOutputImage = TInputImage>
InputPixelType itk::LabelVotingImageFilter< TInputImage, TOutputImage >::m_TotalLabelCount [private]

Definition at line 190 of file itkLabelVotingImageFilter.h.


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