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

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

[legend]List of all members.

Public Types
typedef LabelVotingImageFilter	Self
typedef ImageToImageFilter< TInputImage, TOutputImage >	Superclass
typedef SmartPointer< Self >	Pointer
typedef SmartPointer< const Self >	ConstPointer
typedef TOutputImage::PixelType	OutputPixelType
typedef TInputImage::PixelType	InputPixelType
typedef TInputImage	InputImageType
typedef TOutputImage	OutputImageType
typedef InputImageType::ConstPointer	InputImagePointer
typedef OutputImageType::Pointer	OutputImagePointer
typedef Superclass::OutputImageRegionType	OutputImageRegionType
Public Member Functions
virtual const char *	GetNameOfClass () const
	itkStaticConstMacro (ImageDimension, unsigned int, TOutputImage::ImageDimension)
OutputPixelType	GetLabelForUndecidedPixels () const
void	SetLabelForUndecidedPixels (const OutputPixelType l)
void	UnsetLabelForUndecidedPixels ()
Static Public Member Functions
Pointer	New ()
Protected Member Functions
	LabelVotingImageFilter ()
virtual	~LabelVotingImageFilter ()
void	PrintSelf (std::ostream &, Indent) const
InputPixelType	ComputeMaximumInputValue ()
void	BeforeThreadedGenerateData ()
void	ThreadedGenerateData (const OutputImageRegionType &outputRegionForThread, int threadId)

---

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 74 of file itkLabelVotingImageFilter.h.

---

Member Typedef Documentation

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

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

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

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

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 101 of file itkLabelVotingImageFilter.h.

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

Definition at line 93 of file itkLabelVotingImageFilter.h. Referenced by itk::LabelVotingImageFilter< TInputImage, TOutputImage >::LabelVotingImageFilter().

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

Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 104 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 107 of file itkLabelVotingImageFilter.h. Referenced by itk::LabelVotingImageFilter< TInputImage, TOutputImage >::LabelVotingImageFilter().

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

Some convenient typedefs. Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 102 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 92 of file itkLabelVotingImageFilter.h. Referenced by itk::LabelVotingImageFilter< TInputImage, TOutputImage >::LabelVotingImageFilter(), and itk::LabelVotingImageFilter< TInputImage, TOutputImage >::SetLabelForUndecidedPixels().

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

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

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 79 of file itkLabelVotingImageFilter.h. Referenced by itk::LabelVotingImageFilter< TInputImage, TOutputImage >::LabelVotingImageFilter().

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

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

---

Constructor & Destructor Documentation

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

Definition at line 143 of file itkLabelVotingImageFilter.h. References itk::LabelVotingImageFilter< TInputImage, TOutputImage >::InputPixelType, itk::LabelVotingImageFilter< TInputImage, TOutputImage >::OutputImageRegionType, itk::LabelVotingImageFilter< TInputImage, TOutputImage >::OutputPixelType, and itk::LabelVotingImageFilter< TInputImage, TOutputImage >::Self.

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

Definition at line 144 of file itkLabelVotingImageFilter.h.

---

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> 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 125 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> itk::LabelVotingImageFilter< TInputImage, TOutputImage >::itkStaticConstMacro (  ImageDimension  , unsigned  int, TOutputImage::ImageDimension  )

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

template<typename TInputImage, typename TOutputImage = TInputImage> 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 >::PrintSelf (  std::ostream &  , 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 111 of file itkLabelVotingImageFilter.h. References itk::LabelVotingImageFilter< TInputImage, TOutputImage >::OutputPixelType.

template<typename TInputImage, typename TOutputImage = TInputImage> void itk::LabelVotingImageFilter< TInputImage, TOutputImage >::ThreadedGenerateData (  const OutputImageRegionType &  outputRegionForThread, int  threadId )  [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> void itk::LabelVotingImageFilter< TInputImage, TOutputImage >::UnsetLabelForUndecidedPixels (   )  [inline]

Unset label value for undecided pixels and turn on automatic selection. Definition at line 132 of file itkLabelVotingImageFilter.h.

---

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

• itkLabelVotingImageFilter.h

---