ITK
4.1.0
Insight Segmentation and Registration Toolkit
|
#include <itkConfidenceConnectedImageFilter.h>
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 recalculated 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 63 of file itkConfidenceConnectedImageFilter.h.
typedef SmartPointer< const Self > itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::ConstPointer |
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Definition at line 71 of file itkConfidenceConnectedImageFilter.h.
typedef InputImageType::IndexType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::IndexType |
Definition at line 84 of file itkConfidenceConnectedImageFilter.h.
typedef InputImageType::PixelType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::InputImagePixelType |
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Definition at line 83 of file itkConfidenceConnectedImageFilter.h.
typedef InputImageType::Pointer itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::InputImagePointer |
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Definition at line 81 of file itkConfidenceConnectedImageFilter.h.
typedef InputImageType::RegionType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::InputImageRegionType |
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Definition at line 82 of file itkConfidenceConnectedImageFilter.h.
typedef TInputImage itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::InputImageType |
Some convenient typedefs.
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Definition at line 78 of file itkConfidenceConnectedImageFilter.h.
typedef NumericTraits< InputImagePixelType >::RealType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::InputRealType |
Definition at line 95 of file itkConfidenceConnectedImageFilter.h.
typedef OutputImageType::PixelType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::OutputImagePixelType |
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Definition at line 90 of file itkConfidenceConnectedImageFilter.h.
typedef OutputImageType::Pointer itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::OutputImagePointer |
Reimplemented from itk::ImageSource< TOutputImage >.
Definition at line 88 of file itkConfidenceConnectedImageFilter.h.
typedef OutputImageType::RegionType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::OutputImageRegionType |
Superclass typedefs.
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Definition at line 89 of file itkConfidenceConnectedImageFilter.h.
typedef TOutputImage itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::OutputImageType |
Some convenient typedefs.
Reimplemented from itk::ImageSource< TOutputImage >.
Definition at line 87 of file itkConfidenceConnectedImageFilter.h.
typedef SmartPointer< Self > itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::Pointer |
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Definition at line 70 of file itkConfidenceConnectedImageFilter.h.
typedef std::vector< IndexType > itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SeedsContainerType |
Definition at line 92 of file itkConfidenceConnectedImageFilter.h.
typedef ConfidenceConnectedImageFilter itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::Self |
Standard class typedefs.
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Definition at line 68 of file itkConfidenceConnectedImageFilter.h.
typedef InputImageType::SizeType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SizeType |
Definition at line 85 of file itkConfidenceConnectedImageFilter.h.
typedef ImageToImageFilter< TInputImage, TOutputImage > itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::Superclass |
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Definition at line 69 of file itkConfidenceConnectedImageFilter.h.
itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::ConfidenceConnectedImageFilter | ( | ) | [protected] |
End concept checking
itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::~ConfidenceConnectedImageFilter | ( | ) | [inline, protected] |
Definition at line 154 of file itkConfidenceConnectedImageFilter.h.
itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::ConfidenceConnectedImageFilter | ( | const Self & | ) | [private] |
void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::AddSeed | ( | const IndexType & | seed | ) |
Add seed point.
void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::ClearSeeds | ( | ) |
Clear all the seeds.
virtual::itk::LightObject::Pointer itk::ConfidenceConnectedImageFilter< 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.
void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::EnlargeOutputRequestedRegion | ( | DataObject * | ) | [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.
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.
Reimplemented from itk::ImageSource< 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.
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
virtual const unsigned int& itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetInitialNeighborhoodRadius | ( | ) | [virtual] |
Get/Set the radius of the neighborhood over which the statistics are evaluated
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.
virtual double itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetMultiplier | ( | ) | const [virtual] |
Set/Get the multiplier to define the confidence interval. Multiplier can be anything greater than zero. A typical value is 2.5
virtual const char* itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetNameOfClass | ( | ) | const [virtual] |
Run-time type information (and related methods).
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
virtual unsigned int itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetNumberOfIterations | ( | ) | const [virtual] |
Set/Get the number of iterations
virtual OutputImagePixelType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetReplaceValue | ( | ) | const [virtual] |
Set/Get value to replace thresholded pixels
virtual const SeedsContainerType& itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::GetSeeds | ( | ) | const [virtual] |
Method to access seed container
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.
static Pointer itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::New | ( | ) | [static] |
Method for creation through the object factory.
Reimplemented from itk::Object.
void itk::ConfidenceConnectedImageFilter< 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 >.
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 >.
virtual void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SetInitialNeighborhoodRadius | ( | unsigned int | _arg | ) | [virtual] |
Get/Set the radius of the neighborhood over which the statistics are evaluated
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
virtual void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SetNumberOfIterations | ( | unsigned int | _arg | ) | [virtual] |
Set/Get the number of iterations
virtual void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SetReplaceValue | ( | OutputImagePixelType | _arg | ) | [virtual] |
Set/Get value to replace thresholded pixels
void itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::SetSeed | ( | const IndexType & | seed | ) |
Set seed point. This method is deprecated, please use AddSeed()
itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::typedef | ( | Concept::HasNumericTraits< InputImagePixelType > | ) |
Begin concept checking This class requires InputHasNumericTraitsCheck in the form of ( Concept::HasNumericTraits< InputImagePixelType > )
itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::typedef | ( | Concept::HasNumericTraits< OutputImagePixelType > | ) |
This class requires OutputHasNumericTraitsCheck in the form of ( Concept::HasNumericTraits< OutputImagePixelType > )
unsigned int itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::m_InitialNeighborhoodRadius [private] |
Definition at line 172 of file itkConfidenceConnectedImageFilter.h.
InputRealType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::m_Mean [private] |
Definition at line 173 of file itkConfidenceConnectedImageFilter.h.
double itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::m_Multiplier [private] |
Definition at line 169 of file itkConfidenceConnectedImageFilter.h.
unsigned int itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::m_NumberOfIterations [private] |
Definition at line 170 of file itkConfidenceConnectedImageFilter.h.
OutputImagePixelType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::m_ReplaceValue [private] |
Definition at line 171 of file itkConfidenceConnectedImageFilter.h.
SeedsContainerType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::m_Seeds [private] |
Definition at line 168 of file itkConfidenceConnectedImageFilter.h.
InputRealType itk::ConfidenceConnectedImageFilter< TInputImage, TOutputImage >::m_Variance [private] |
Definition at line 174 of file itkConfidenceConnectedImageFilter.h.