ITK
4.3.0
Insight Segmentation and Registration Toolkit
|
#include <itkObjectMorphologyImageFilter.h>
Base class for the morphological operations being applied to isolated objects in an image.
This class provides the infrastructure to support of morphological operations being applied to images in which the foreground and background intensities are fixed. This filter operates significantly faster than itkBinaryMorhologicalImageFilters; however itkBinaryMorhologicalImageFilters preserve background pixels based on values of neighboring background pixels - potentially important during erosion.
The "kernel" specified represents a morphology structuring element. The structuring element is a small Neighborhood with values indicating an element is "on" (value > 0) or "off" (value <=0). Morphological operations are defined by placing the structuring element over a pixel, and calculating a nonlinear function (min, max) over the pixels of the image that are under pixels in the structuring element that are "on". The result of this calculation is the value of the pixel in the output image. Under most circumstances, the "center pixel" of the structuring element – or structuring element pixel over the input pixel under consideration – is prescribed to be "on". This is not a strict requirement but the subclasses of this filter are not guaranteed to produce the correct result if the "center pixel" is not part of the structuring element.
Subclasses of this class can define their own operations by simply providing their own Evaluate() protected member functions - one that operates using a smart neighborhood operator for edge faces and one that operates using a standard neighboorhood operator..
Definition at line 73 of file itkObjectMorphologyImageFilter.h.
Static Public Attributes | |
static const unsigned int | ImageDimension = TInputImage::ImageDimension |
static const unsigned int | OutputImageDimension = TOutputImage::ImageDimension |
static const unsigned int | KernelDimension = TKernel::NeighborhoodDimension |
Static Public Attributes inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
static const unsigned int | InputImageDimension = TInputImage::ImageDimension |
static const unsigned int | OutputImageDimension = TOutputImage::ImageDimension |
Static Public Attributes inherited from itk::ImageSource< TOutputImage > | |
static const unsigned int | OutputImageDimension = TOutputImage::ImageDimension |
Private Member Functions | |
ObjectMorphologyImageFilter (const Self &) | |
void | operator= (const Self &) |
Additional Inherited Members | |
Static Public Member Functions inherited from itk::Object | |
static bool | GetGlobalWarningDisplay () |
static void | GlobalWarningDisplayOff () |
static void | GlobalWarningDisplayOn () |
static Pointer | New () |
static void | SetGlobalWarningDisplay (bool flag) |
Protected Types inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
typedef ImageToImageFilterDetail::ImageRegionCopier < itkGetStaticConstMacro(OutputImageDimension), itkGetStaticConstMacro(InputImageDimension) > | InputToOutputRegionCopierType |
typedef ImageToImageFilterDetail::ImageRegionCopier < itkGetStaticConstMacro(InputImageDimension), itkGetStaticConstMacro(OutputImageDimension) > | OutputToInputRegionCopierType |
Static Protected Member Functions inherited from itk::ImageSource< TOutputImage > | |
static ITK_THREAD_RETURN_TYPE | ThreaderCallback (void *arg) |
typedef SmartPointer< const Self > itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::ConstPointer |
Definition at line 81 of file itkObjectMorphologyImageFilter.h.
typedef ConstantBoundaryCondition< InputImageType > itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::DefaultBoundaryConditionType |
Definition at line 101 of file itkObjectMorphologyImageFilter.h.
typedef ImageBoundaryCondition< InputImageType > const* itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::ImageBoundaryConditionConstPointerType |
Definition at line 99 of file itkObjectMorphologyImageFilter.h.
typedef ImageBoundaryCondition< InputImageType >* itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::ImageBoundaryConditionPointerType |
Definition at line 97 of file itkObjectMorphologyImageFilter.h.
typedef TInputImage::IndexType itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::IndexType |
Definition at line 91 of file itkObjectMorphologyImageFilter.h.
typedef TInputImage itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::InputImageType |
Image related typedefs.
Definition at line 84 of file itkObjectMorphologyImageFilter.h.
typedef ConstNeighborhoodIterator< TInputImage > itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::InputNeighborhoodIteratorType |
Neighborhood iterator type.
Definition at line 114 of file itkObjectMorphologyImageFilter.h.
typedef KernelType::ConstIterator itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::KernelIteratorType |
Kernel (structuring element) iterator.
Definition at line 122 of file itkObjectMorphologyImageFilter.h.
typedef TKernel itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::KernelType |
Kernel typedef.
Definition at line 119 of file itkObjectMorphologyImageFilter.h.
typedef Superclass::OutputImageRegionType itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::OutputImageRegionType |
Definition at line 94 of file itkObjectMorphologyImageFilter.h.
typedef TOutputImage itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::OutputImageType |
Definition at line 88 of file itkObjectMorphologyImageFilter.h.
typedef NeighborhoodIterator< TOutputImage > itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::OutputNeighborhoodIteratorType |
Definition at line 116 of file itkObjectMorphologyImageFilter.h.
typedef TInputImage::PixelType itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::PixelType |
Definition at line 92 of file itkObjectMorphologyImageFilter.h.
typedef SmartPointer< Self > itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::Pointer |
Definition at line 80 of file itkObjectMorphologyImageFilter.h.
typedef KernelType::SizeType itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::RadiusType |
n-dimensional Kernel radius.
Definition at line 125 of file itkObjectMorphologyImageFilter.h.
typedef TInputImage::RegionType itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::RegionType |
Definition at line 89 of file itkObjectMorphologyImageFilter.h.
typedef ObjectMorphologyImageFilter itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::Self |
Standard Self typedef
Definition at line 78 of file itkObjectMorphologyImageFilter.h.
typedef TInputImage::SizeType itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::SizeType |
Definition at line 90 of file itkObjectMorphologyImageFilter.h.
typedef ImageToImageFilter< TInputImage, TOutputImage > itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::Superclass |
Definition at line 79 of file itkObjectMorphologyImageFilter.h.
|
protected |
End concept checking
|
inlineprotected |
Definition at line 197 of file itkObjectMorphologyImageFilter.h.
|
private |
|
protectedvirtual |
If an imaging filter needs to perform processing after the buffer has been allocated but before threads are spawned, the filter can can provide an implementation for BeforeThreadedGenerateData(). The execution flow in the default GenerateData() method will be: 1) Allocate the output buffer 2) Call BeforeThreadedGenerateData() 3) Spawn threads, calling ThreadedGenerateData() in each thread. 4) Call AfterThreadedGenerateData() Note that this flow of control is only available if a filter provides a ThreadedGenerateData() method and NOT a GenerateData() method.
Reimplemented from itk::ImageSource< TOutputImage >.
|
protectedpure virtual |
Evaluate image neighborhood with kernel to find the new value for the center pixel value.
Implemented in itk::ErodeObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >, and itk::DilateObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >.
|
virtual |
ObjectMorphologyImageFilters need to make sure they request enough of an input image to account for the structuring element size. The input requested region is expanded by the radius of the structuring element. If the request extends past the LargestPossibleRegion for the input, the request is cropped by the LargestPossibleRegion.
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
|
virtual |
Get the current boundary condition.
|
virtual |
Get the kernel (structuring element).
|
virtual |
Runtime information support.
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Reimplemented in itk::DilateObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >, and itk::ErodeObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >.
|
virtual |
Get the pixel value being used to identify the object of interest
|
virtual |
Enable/disable the use of boundary condition. Defaults to false. if false, a neighborhood operator extends outside an image, it does not consider that outside extent when determining if a pixel is on an object's boundary.
|
protected |
Evaluate a pixel (assumed to have a value of ObjectValue) to determine if one of its neighboring pixels (8-neigh in 2d, etc) is a non-ObjectValue pixel.
|
private |
|
inline |
Allows a user to override the internal boundary condition. Care should be be taken to ensure that the overriding boundary condition is a persistent object during the time it is referenced. The overriding condition can be of a different type than the default type as long as it is a subclass of ImageBoundaryCondition. NOTE: Don't foget to set UseBoundaryCondition to true!
Definition at line 152 of file itkObjectMorphologyImageFilter.h.
|
protectedvirtual |
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 >.
|
inline |
Rest the boundary condition to the default
Definition at line 156 of file itkObjectMorphologyImageFilter.h.
|
virtual |
Set kernel (structuring element).
|
virtual |
Set the pixel value being used to identify the object of interest
|
virtual |
Enable/disable the use of boundary condition. Defaults to false. if false, a neighborhood operator extends outside an image, it does not consider that outside extent when determining if a pixel is on an object's boundary.
|
protectedvirtual |
Multi-thread version GenerateData.
Reimplemented from itk::ImageSource< TOutputImage >.
itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::typedef | ( | Concept::SameDimension< ImageDimension, OutputImageDimension > | ) |
Begin concept checking This class requires SameDimensionCheck1 in the form of ( Concept::SameDimension< ImageDimension, OutputImageDimension > )
itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::typedef | ( | Concept::SameDimension< ImageDimension, KernelDimension > | ) |
This class requires SameDimensionCheck2 in the form of ( Concept::SameDimension< ImageDimension, KernelDimension > )
itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::typedef | ( | Concept::EqualityComparable< typename TOutputImage::PixelType, PixelType > | ) |
This class requires OutputInputEqualityComparableCheck in the form of ( Concept::EqualityComparable< typename TOutputImage::PixelType, PixelType > )
itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::typedef | ( | Concept::Convertible< PixelType, typename TOutputImage::PixelType > | ) |
This class requires InputConvertibleToOutputCheck in the form of ( Concept::Convertible< PixelType, typename TOutputImage::PixelType > )
itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::typedef | ( | Concept::Convertible< int, typename TOutputImage::PixelType > | ) |
This class requires IntConvertibleToOutputCheck in the form of ( Concept::Convertible< int, typename TOutputImage::PixelType > )
itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::typedef | ( | Concept::EqualityComparable< PixelType > | ) |
This class requires InputEqualityComparable in the form of ( Concept::EqualityComparable< PixelType > )
itk::ObjectMorphologyImageFilter< TInputImage, TOutputImage, TKernel >::typedef | ( | Concept::OStreamWritable< PixelType > | ) |
This class requires InputOStreamWritableCheck in the form of ( Concept::OStreamWritable< PixelType > )
|
static |
Image related typedefs.
Definition at line 105 of file itkObjectMorphologyImageFilter.h.
|
static |
Image related typedefs.
Definition at line 109 of file itkObjectMorphologyImageFilter.h.
|
protected |
Pointer to a persistent boundary condition object used for the image iterator.
Definition at line 217 of file itkObjectMorphologyImageFilter.h.
|
protected |
Default boundary condition
Definition at line 220 of file itkObjectMorphologyImageFilter.h.
|
protected |
kernel or structuring element to use.
Definition at line 226 of file itkObjectMorphologyImageFilter.h.
|
protected |
Pixel value that indicates the object be operated upon
Definition at line 229 of file itkObjectMorphologyImageFilter.h.
|
protected |
Defaults to false
Definition at line 223 of file itkObjectMorphologyImageFilter.h.
|
static |
Image related typedefs.
Definition at line 107 of file itkObjectMorphologyImageFilter.h.