ITK
6.0.0
Insight Toolkit
|
#include <itkRegionGrowImageFilter.h>
Base class for RegionGrowImageFilter object.
itkRegionGrowImageFilter is the base class for the RegionGrowImageFilter objects. It provides the basic function definitions that are inherent to a RegionGrowImageFilter objects. It is templated over the type of input and output image.
This object defines the interface for those algorithm that perform feature/object segmentation by merging regions (parts of the image) that are similar in nature based on some metric. As a result parts of the image which belong to the same object gets merged and the region grows.
As an example regarding using this class to implementation of advanced region growing algorithm, itkRegionGrowImageFilterKLM class has been derived from this class. The virtual function ApplyRegionGrowImageFilter() provides the interface to the outside world to extend/enhance the scope of the current algorithm or write other region growing algorithms. The function MergeRegions is interface for the operation that merges two regions.
The local variable GridSize is used to define the initial small regions that the image is fragmented (atomic regions) into. For an 12 x 12 input image, GridSize set equal to [3, 3] will result in 16 initial regions. The default values are set equal to 2. The user can sets the number of desired regions via the m_MaxNumRegions parameter and the algorithm tries to perform region merging until there are only m_MaxNumRegions. If m_MaxNumRegions is more than the number of initial blocks, no region merging occurs.
These blocks are important as the labels associated with these blocks keep changing during the region growing process and at the end, while generating the results, each of these atomic blocks are revisited and the blocks with same labels are considered to belong to the same region.
This object supports data handling of multiband images. The object accepts images in vector format, where each pixel is a vector and each element of the vector corresponds to an entry from 1 particular band of a multiband dataset. The input to this object is assumed to be a multiband vector image, and the output is defined by specific algorithm implementation. The second template parameter is used to generate the the output image and can be modified according the algorithm specific output type.
We expect the user to provide the input to the routine in vector format. A single band image is treated as a vector image with a single element for every vector.
Definition at line 85 of file itkRegionGrowImageFilter.h.
Private Attributes | |
GridSizeType | m_GridSize {} |
unsigned int | m_MaximumNumberOfRegions {} |
Additional Inherited Members | |
Static Public Member Functions inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
static double | GetGlobalDefaultCoordinateTolerance () |
static double | GetGlobalDefaultDirectionTolerance () |
static void | SetGlobalDefaultCoordinateTolerance (double) |
static void | SetGlobalDefaultDirectionTolerance (double) |
Static Public Member Functions inherited from itk::Object | |
static bool | GetGlobalWarningDisplay () |
static void | GlobalWarningDisplayOff () |
static void | GlobalWarningDisplayOn () |
static Pointer | New () |
static void | SetGlobalWarningDisplay (bool val) |
Static Public Member Functions inherited from itk::LightObject | |
static void | BreakOnError () |
static Pointer | New () |
Static Public Attributes inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
static constexpr unsigned int | InputImageDimension = TInputImage::ImageDimension |
static constexpr unsigned int | OutputImageDimension = TOutputImage::ImageDimension |
Static Public Attributes inherited from itk::ImageSource< TOutputImage > | |
static constexpr unsigned int | OutputImageDimension = TOutputImage::ImageDimension |
Protected Types inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
using | InputToOutputRegionCopierType = ImageToImageFilterDetail::ImageRegionCopier< Self::OutputImageDimension, Self::InputImageDimension > |
using | OutputToInputRegionCopierType = ImageToImageFilterDetail::ImageRegionCopier< Self::InputImageDimension, Self::OutputImageDimension > |
Static Protected Member Functions inherited from itk::ImageSource< TOutputImage > | |
static const ImageRegionSplitterBase * | GetGlobalDefaultSplitter () |
static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION | ThreaderCallback (void *arg) |
Static Protected Member Functions inherited from itk::ProcessObject | |
template<typename TSourceObject > | |
static void | MakeRequiredOutputs (TSourceObject &sourceObject, const DataObjectPointerArraySizeType numberOfRequiredOutputs) |
static constexpr float | progressFixedToFloat (uint32_t fixed) |
static uint32_t | progressFloatToFixed (float f) |
Protected Attributes inherited from itk::ImageSource< TOutputImage > | |
bool | m_DynamicMultiThreading { true } |
Protected Attributes inherited from itk::ProcessObject | |
TimeStamp | m_OutputInformationMTime {} |
bool | m_Updating {} |
Protected Attributes inherited from itk::LightObject | |
std::atomic< int > | m_ReferenceCount {} |
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::ConstPointer = SmartPointer<const Self> |
Definition at line 94 of file itkRegionGrowImageFilter.h.
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::GridSizeType = typename TInputImage::SizeType |
Type definition for the initial grid.
Definition at line 115 of file itkRegionGrowImageFilter.h.
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::InputImageConstPointer = typename TInputImage::ConstPointer |
Definition at line 102 of file itkRegionGrowImageFilter.h.
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::InputImagePixelType = typename TInputImage::PixelType |
Type definition for the input image pixel type.
Definition at line 105 of file itkRegionGrowImageFilter.h.
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::InputImagePointer = typename TInputImage::Pointer |
Definition at line 101 of file itkRegionGrowImageFilter.h.
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::InputImageType = TInputImage |
Type definition for the input image.
Definition at line 100 of file itkRegionGrowImageFilter.h.
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::OutputImagePixelType = typename TOutputImage::PixelType |
Type definition for the input image pixel type.
Definition at line 112 of file itkRegionGrowImageFilter.h.
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::OutputImagePointer = typename TOutputImage::Pointer |
Definition at line 109 of file itkRegionGrowImageFilter.h.
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::OutputImageType = TOutputImage |
Type definition for the output image.
Definition at line 108 of file itkRegionGrowImageFilter.h.
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::Pointer = SmartPointer<Self> |
Definition at line 93 of file itkRegionGrowImageFilter.h.
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::Self = RegionGrowImageFilter |
Standard class type aliases.
Definition at line 91 of file itkRegionGrowImageFilter.h.
using itk::RegionGrowImageFilter< TInputImage, TOutputImage >::Superclass = ImageToImageFilter<TInputImage, TOutputImage> |
Definition at line 92 of file itkRegionGrowImageFilter.h.
|
protected |
|
overrideprotecteddefault |
|
pure virtual |
Define a virtual RegionGrowImageFilter function.
Implemented in itk::KLMRegionGrowImageFilter< TInputImage, TOutputImage >.
|
virtual |
Set/Get the initial grid.
|
virtual |
Set/Get the number of regions desired.
|
overridevirtual |
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
|
pure virtual |
Merge two regions.
Implemented in itk::KLMRegionGrowImageFilter< TInputImage, TOutputImage >.
|
overrideprotectedvirtual |
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 |
Set/Get the initial grid.
|
virtual |
Set/Get the number of regions desired.
|
private |
Definition at line 144 of file itkRegionGrowImageFilter.h.
|
private |
Definition at line 142 of file itkRegionGrowImageFilter.h.