#include <itkValuedRegionalExtremaImageFilter.h>
Uses a flooding algorithm to set all voxels that are not a regional extrema to the max or min of the pixel type.
This is the class used by ValuedRegionalMinimaImageFilter and ValuedRegionalMaximaImageFilter. There is no suppression of regional minima based on dynamics, as available in HMinimaImageFilter. This flooding algorithm is a very simple one, but I'm not sure where it came from - I certainly didn't invent it.
Let's consider the case of regional minima. The basic algorithm is: Boundary conditions are such that the image is logically surrounded by a border that is either maximal or minimal for the pixel type. An optimized version could explicitly set the border to avoid the need for boundary checks. For regional minima the boundary is set to the maximal value for the pixel type.
Pixels are visited in raster order. The neighbors of each pixel are examined. If any neighbor is greater than the centre, then the centre pixel cannot be a regional minima. The centre pixel is part of a flat region (consisting of at least one pixel) that is therefore not a regional minima either. This region is set to the maximum value for the pixel type using a flooding algorithm.
There are some minor complications that prevent pixels being examined more than once – basically check that the output value is less than the maximum for the pixel type.
The implementation uses the functor model from itkMaximumImageFilter.
This code was contributed in the Insight Journal paper: "Finding regional extrema - methods and performance" by Beare R., Lehmann G. https://doi.org/10.54294/hva3gz
Definition at line 77 of file itkValuedRegionalExtremaImageFilter.h.
Inheritance diagram for itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >:
Collaboration diagram for itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >:Public Types | |
| using | ConstPointer = SmartPointer<const Self> |
| using | InputImageConstPointer = typename InputImageType::ConstPointer |
| using | InputImagePixelType = typename InputImageType::PixelType |
| using | InputImagePointer = typename InputImageType::Pointer |
| using | InputImageRegionType = typename InputImageType::RegionType |
| using | InputImageType = TInputImage |
| using | ISizeType = typename InputImageType::SizeType |
| using | OutputImageConstPointer = typename OutputImageType::ConstPointer |
| using | OutputImagePixelType = typename OutputImageType::PixelType |
| using | OutputImagePointer = typename OutputImageType::Pointer |
| using | OutputImageRegionType = typename OutputImageType::RegionType |
| using | OutputImageType = TOutputImage |
| using | Pointer = SmartPointer<Self> |
| using | Self = ValuedRegionalExtremaImageFilter |
| using | Superclass = ImageToImageFilter<TInputImage, TOutputImage> |
Public Types inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
| using | ConstPointer = SmartPointer<const Self> |
| using | InputImageConstPointer = typename InputImageType::ConstPointer |
| using | InputImagePixelType = typename InputImageType::PixelType |
| using | InputImagePointer = typename InputImageType::Pointer |
| using | InputImageRegionType = typename InputImageType::RegionType |
| using | InputImageType = TInputImage |
| using | OutputImagePixelType |
| using | OutputImageRegionType |
| using | Pointer = SmartPointer<Self> |
| using | Self = ImageToImageFilter |
| using | Superclass = ImageSource<TOutputImage> |
Public Types inherited from itk::ImageSource< TOutputImage > | |
| using | ConstPointer = SmartPointer<const Self> |
| using | DataObjectIdentifierType = Superclass::DataObjectIdentifierType |
| using | DataObjectPointer = DataObject::Pointer |
| using | DataObjectPointerArraySizeType = Superclass::DataObjectPointerArraySizeType |
| using | OutputImagePixelType = typename OutputImageType::PixelType |
| using | OutputImagePointer = typename OutputImageType::Pointer |
| using | OutputImageRegionType = typename OutputImageType::RegionType |
| using | OutputImageType = TOutputImage |
| using | Pointer = SmartPointer<Self> |
| using | Self = ImageSource |
| using | Superclass = ProcessObject |
Public Types inherited from itk::ProcessObject | |
| using | ConstPointer = SmartPointer<const Self> |
| using | DataObjectIdentifierType = DataObject::DataObjectIdentifierType |
| using | DataObjectPointer = DataObject::Pointer |
| using | DataObjectPointerArray = std::vector<DataObjectPointer> |
| using | DataObjectPointerArraySizeType = DataObjectPointerArray::size_type |
| using | NameArray = std::vector<DataObjectIdentifierType> |
| using | Pointer = SmartPointer<Self> |
| using | Self = ProcessObject |
| using | Superclass = Object |
Public Types inherited from itk::Object | |
| using | ConstPointer = SmartPointer<const Self> |
| using | Pointer = SmartPointer<Self> |
| using | Self = Object |
| using | Superclass = LightObject |
Public Types inherited from itk::LightObject | |
| using | ConstPointer = SmartPointer<const Self> |
| using | Pointer = SmartPointer<Self> |
| using | Self = LightObject |
Static Public Member Functions | |
| static Pointer | New () |
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 | |
| static constexpr unsigned int | InputImageDimension = TInputImage::ImageDimension |
| static constexpr unsigned int | OutputImageDimension = TOutputImage::ImageDimension |
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 |
Private Types | |
| using | ConstInputIterator = ConstShapedNeighborhoodIterator<InputImageType> |
| using | IndexStack = std::stack<OutIndexType> |
| using | InIndexType = typename InputImageType::IndexType |
| using | NOutputIterator = ShapedNeighborhoodIterator<OutputImageType> |
| using | OutIndexType = typename OutputImageType::IndexType |
Private Attributes | |
| bool | m_Flat { false } |
| bool | m_FullyConnected { false } |
| TInputImage::PixelType | m_MarkerValue { 0 } |
Additional Inherited Members | |
Protected Types inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
| using | InputToOutputRegionCopierType |
| using | OutputToInputRegionCopierType |
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 {} |
|
private |
Definition at line 164 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::ConstPointer = SmartPointer<const Self> |
Definition at line 86 of file itkValuedRegionalExtremaImageFilter.h.
|
private |
Definition at line 166 of file itkValuedRegionalExtremaImageFilter.h.
|
private |
Definition at line 163 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::InputImageConstPointer = typename InputImageType::ConstPointer |
Definition at line 92 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::InputImagePixelType = typename InputImageType::PixelType |
Definition at line 94 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::InputImagePointer = typename InputImageType::Pointer |
Definition at line 91 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::InputImageRegionType = typename InputImageType::RegionType |
Definition at line 93 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::InputImageType = TInputImage |
Some convenient type alias.
Definition at line 89 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::ISizeType = typename InputImageType::SizeType |
Definition at line 95 of file itkValuedRegionalExtremaImageFilter.h.
|
private |
Definition at line 165 of file itkValuedRegionalExtremaImageFilter.h.
|
private |
Definition at line 162 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::OutputImageConstPointer = typename OutputImageType::ConstPointer |
Definition at line 97 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::OutputImagePixelType = typename OutputImageType::PixelType |
Definition at line 99 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::OutputImagePointer = typename OutputImageType::Pointer |
Definition at line 96 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::OutputImageRegionType = typename OutputImageType::RegionType |
Definition at line 98 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::OutputImageType = TOutputImage |
Definition at line 90 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::Pointer = SmartPointer<Self> |
Definition at line 85 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::Self = ValuedRegionalExtremaImageFilter |
Standard class type aliases.
Definition at line 83 of file itkValuedRegionalExtremaImageFilter.h.
| using itk::ValuedRegionalExtremaImageFilter< TInputImage, TOutputImage, TFunction1, TFunction2 >::Superclass = ImageToImageFilter<TInputImage, TOutputImage> |
Definition at line 84 of file itkValuedRegionalExtremaImageFilter.h.
|
protecteddefault |
|
overrideprotecteddefault |
|
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.
Reimplemented in itk::ValuedRegionalMaximaImageFilter< TInputImage, TOutputImage >, and itk::ValuedRegionalMinimaImageFilter< TInputImage, TOutputImage >.
|
overrideprotectedvirtual |
ValuedRegionalExtremaImageFilter will produce the entire output.
Reimplemented from itk::ProcessObject.
|
virtual |
Set/Get whether the connected components are defined strictly by face connectivity or by face+edge+vertex connectivity. Default is FullyConnectedOff. For objects that are 1 pixel wide, use FullyConnectedOn.
|
virtual |
Set/Get whether the connected components are defined strictly by face connectivity or by face+edge+vertex connectivity. Default is FullyConnectedOff. For objects that are 1 pixel wide, use FullyConnectedOn.
|
overrideprotectedvirtual |
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 DynamicThreadedGenerateData(). 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 can be threaded, it should NOT provide a GenerateData() method but should provide a DynamicThreadedGenerateData() instead.
Reimplemented from itk::ImageSource< TOutputImage >.
|
overrideprotectedvirtual |
ValuedRegionalExtremaImageFilter needs the entire input be available. Thus, it needs to provide an implementation of GenerateInputRequestedRegion().
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
|
virtual |
Get whether the image is flat or not.
|
virtual |
Set/Get whether the connected components are defined strictly by face connectivity or by face+edge+vertex connectivity. Default is FullyConnectedOff. For objects that are 1 pixel wide, use FullyConnectedOn.
|
virtual |
Set/Get the value used to mark all pixels which are not extrema.
|
virtual |
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Reimplemented in itk::ValuedRegionalMaximaImageFilter< TInputImage, TOutputImage >, and itk::ValuedRegionalMinimaImageFilter< TInputImage, TOutputImage >.
|
static |
Standard New method.
|
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 whether the connected components are defined strictly by face connectivity or by face+edge+vertex connectivity. Default is FullyConnectedOff. For objects that are 1 pixel wide, use FullyConnectedOn.
|
virtual |
Set/Get the value used to mark all pixels which are not extrema.
|
staticconstexpr |
ImageDimension constants
Definition at line 102 of file itkValuedRegionalExtremaImageFilter.h.
|
private |
Definition at line 160 of file itkValuedRegionalExtremaImageFilter.h.
|
private |
Definition at line 159 of file itkValuedRegionalExtremaImageFilter.h.
|
private |
Definition at line 157 of file itkValuedRegionalExtremaImageFilter.h.
|
staticconstexpr |
Definition at line 103 of file itkValuedRegionalExtremaImageFilter.h.