Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
mitk::MRNormTwoRegionsBasedFilter Class Reference

Normalizes MR images using linear scaling based on statistics from two distinct mask regions. More...

#include <mitkMRNormTwoRegionBasedFilter.h>

Inheritance diagram for mitk::MRNormTwoRegionsBasedFilter:
Collaboration diagram for mitk::MRNormTwoRegionsBasedFilter:

Public Types

enum  NormalizationBase { MEAN , MODE , MEDIAN }
 Enumeration for the statistical measure used for normalization. More...
 
- Public Types inherited from mitk::ImageToImageFilter
typedef Superclass::OutputImageRegionType OutputImageRegionType
 Superclass typedefs. More...
 
typedef mitk::Image InputImageType
 Some convenient typedefs. More...
 
typedef InputImageType::Pointer InputImagePointer
 
typedef InputImageType::ConstPointer InputImageConstPointer
 
typedef SlicedData::RegionType InputImageRegionType
 
- Public Types inherited from mitk::ImageSource
typedef mitk::Image OutputImageType
 Some convenient typedefs. More...
 
typedef OutputImageType OutputType
 
typedef OutputImageType::Pointer OutputImagePointer
 
typedef SlicedData::RegionType OutputImageRegionType
 
- Public Types inherited from mitk::BaseDataSource
typedef BaseData OutputType
 Output data type. More...
 
typedef itk::DataObject::DataObjectIdentifierType DataObjectIdentifierType
 Identifier type for named data objects. More...
 

Public Member Functions

 mitkClassMacro (MRNormTwoRegionsBasedFilter, ImageToImageFilter)
 
Pointer Clone () const
 
void SetMask1 (const mitk::Image *mask)
 Set the first mask image defining the first reference region. More...
 
void SetMask2 (const mitk::Image *mask)
 Set the second mask image defining the second reference region. More...
 
const mitk::Image * GetMask1 () const
 Get the first mask image. More...
 
const mitk::Image * GetMask2 () const
 Get the second mask image. More...
 
virtual NormalizationBase GetArea1 () const
 
virtual NormalizationBase GetArea2 () const
 
virtual void SetArea1 (NormalizationBase _arg)
 
virtual void SetArea2 (NormalizationBase _arg)
 
- Public Member Functions inherited from mitk::ImageToImageFilter
 mitkClassMacro (ImageToImageFilter, ImageSource)
 
Pointer Clone () const
 
virtual void SetInput (const InputImageType *image)
 Set the image input of this process object. More...
 
virtual void SetInput (unsigned int idx, const InputImageType *image)
 Set the image input at the specified index. More...
 
InputImageType * GetInput (void)
 Get the input image (non-const). More...
 
InputImageType * GetInput (unsigned int idx)
 Get the input image at the specified index (non-const). More...
 
const InputImageType * GetInput (void) const
 Get the input image (const). More...
 
const InputImageType * GetInput (unsigned int idx) const
 Get the input image at the specified index (const). More...
 
- Public Member Functions inherited from mitk::ImageSource
 mitkClassMacro (ImageSource, BaseDataSource)
 
Pointer Clone () const
 
mitkBaseDataSourceGetOutputDeclarations itk::DataObject::Pointer MakeOutput (DataObjectPointerArraySizeType idx) override
 Get the output data of this image source object. More...
 
itk::DataObject::Pointer MakeOutput (const DataObjectIdentifierType &name) override
 
virtual vtkImageData * GetVtkImageData ()
 Get the output as VTK image data (non-const version). More...
 
virtual const vtkImageData * GetVtkImageData () const
 Get the output as VTK image data (const version). More...
 
- Public Member Functions inherited from mitk::BaseDataSource
 mitkClassMacroItkParent (BaseDataSource, itk::ProcessObject)
 
OutputType * GetOutput ()
 
const OutputType * GetOutput () const
 
OutputType * GetOutput (DataObjectPointerArraySizeType idx)
 
const OutputType * GetOutput (DataObjectPointerArraySizeType idx) const
 
virtual void GraftOutput (OutputType *output)
 Graft the specified BaseData onto this BaseDataSource's output. More...
 
virtual void GraftOutput (const DataObjectIdentifierType &key, OutputType *output)
 Graft the specified base data object onto a named output. More...
 
virtual void GraftNthOutput (unsigned int idx, OutputType *output)
 Graft the specified base data object onto this BaseDataSource's idx'th output. More...
 
bool Updating () const
 Check whether the pipeline is currently executing. More...
 

Static Public Member Functions

static Pointer New ()
 
- Static Public Member Functions inherited from mitk::ImageToImageFilter
static Pointer New ()
 Method for creation through the object factory. More...
 
- Static Public Member Functions inherited from mitk::ImageSource
static Pointer New ()
 Method for creation through the object factory. More...
 

Protected Member Functions

 MRNormTwoRegionsBasedFilter ()
 
 ~MRNormTwoRegionsBasedFilter () override
 
void GenerateInputRequestedRegion () override
 
void GenerateOutputInformation () override
 
void GenerateData () override
 
template<typename TPixel , unsigned int VImageDimension>
void InternalComputeMask (itk::Image< TPixel, VImageDimension > *itkImage)
 Internal templated implementation that computes statistics and normalizes the image. More...
 
- Protected Member Functions inherited from mitk::ImageToImageFilter
 ImageToImageFilter ()
 
 ~ImageToImageFilter () override
 
void PrintSelf (std::ostream &os, itk::Indent indent) const override
 Print self information to the given stream. More...
 
void GenerateInputRequestedRegion () override
 Determine the input requested region to produce the output requested region. More...
 
- Protected Member Functions inherited from mitk::ImageSource
 ImageSource ()
 
 ~ImageSource () override
 
void GenerateData () override
 A version of GenerateData() specific for image processing filters. More...
 
virtual void ThreadedGenerateData (const OutputImageRegionType &outputRegionForThread, itk::ThreadIdType threadId)
 If an imaging filter can be implemented as a multithreaded algorithm, the filter will provide an implementation of ThreadedGenerateData(). More...
 
void PrepareOutputs () override
 This method is intentionally left blank. More...
 
virtual void AllocateOutputs ()
 The GenerateData method normally allocates the buffers for all of the outputs of a filter. More...
 
virtual void BeforeThreadedGenerateData ()
 If an imaging filter needs to perform processing after the buffer has been allocated but before threads are spawned, the filter can provide an implementation for BeforeThreadedGenerateData(). More...
 
virtual void AfterThreadedGenerateData ()
 If an imaging filter needs to perform processing after all processing threads have completed, the filter can provide an implementation for AfterThreadedGenerateData(). More...
 
virtual unsigned int SplitRequestedRegion (unsigned int i, unsigned int num, OutputImageRegionType &splitRegion)
 Split the output's RequestedRegion into "num" pieces, returning region "i" as "splitRegion". More...
 
- Protected Member Functions inherited from mitk::BaseDataSource
 BaseDataSource ()
 Constructor. More...
 
 ~BaseDataSource () override
 Destructor. More...
 

Protected Attributes

NormalizationBase m_Area1
 
NormalizationBase m_Area2
 

Additional Inherited Members

- Static Protected Member Functions inherited from mitk::ImageSource
static itk::ITK_THREAD_RETURN_TYPE ThreaderCallback (void *arg)
 Static function used as a "callback" by the MultiThreader. More...
 
- Static Protected Member Functions inherited from mitk::BaseDataSource
static Pointer New ()
 

Detailed Description

Normalizes MR images using linear scaling based on statistics from two distinct mask regions.

This filter computes a statistical measure (mean, median, or mode) in each of two masked regions and normalizes the input image linearly between the two values: output = (input - min(value1, value2)) / (max(value1, value2) - min(value1, value2)).

Definition at line 33 of file mitkMRNormTwoRegionBasedFilter.h.

Member Enumeration Documentation

◆ NormalizationBase

Enumeration for the statistical measure used for normalization.

Enumerator
MEAN 

Use the arithmetic mean.

MODE 

Use the histogram mode.

MEDIAN 

Use the median.

Definition at line 66 of file mitkMRNormTwoRegionBasedFilter.h.

Constructor & Destructor Documentation

◆ MRNormTwoRegionsBasedFilter()

mitk::MRNormTwoRegionsBasedFilter::MRNormTwoRegionsBasedFilter ( )
protected

◆ ~MRNormTwoRegionsBasedFilter()

mitk::MRNormTwoRegionsBasedFilter::~MRNormTwoRegionsBasedFilter ( )
overrideprotected

Member Function Documentation

◆ Clone()

Pointer mitk::MRNormTwoRegionsBasedFilter::Clone ( ) const

◆ GenerateData()

void mitk::MRNormTwoRegionsBasedFilter::GenerateData ( )
overrideprotected

◆ GenerateInputRequestedRegion()

void mitk::MRNormTwoRegionsBasedFilter::GenerateInputRequestedRegion ( )
overrideprotected

◆ GenerateOutputInformation()

void mitk::MRNormTwoRegionsBasedFilter::GenerateOutputInformation ( )
overrideprotected

◆ GetArea1()

virtual NormalizationBase mitk::MRNormTwoRegionsBasedFilter::GetArea1 ( ) const
virtual

◆ GetArea2()

virtual NormalizationBase mitk::MRNormTwoRegionsBasedFilter::GetArea2 ( ) const
virtual

◆ GetMask1()

const mitk::Image* mitk::MRNormTwoRegionsBasedFilter::GetMask1 ( ) const

Get the first mask image.

Returns
Pointer to the first mask image, or nullptr if not set.

◆ GetMask2()

const mitk::Image* mitk::MRNormTwoRegionsBasedFilter::GetMask2 ( ) const

Get the second mask image.

Returns
Pointer to the second mask image, or nullptr if not set.

◆ InternalComputeMask()

template<typename TPixel , unsigned int VImageDimension>
void mitk::MRNormTwoRegionsBasedFilter::InternalComputeMask ( itk::Image< TPixel, VImageDimension > *  itkImage)
protected

Internal templated implementation that computes statistics and normalizes the image.

◆ mitkClassMacro()

mitk::MRNormTwoRegionsBasedFilter::mitkClassMacro ( MRNormTwoRegionsBasedFilter  ,
ImageToImageFilter   
)

◆ New()

static Pointer mitk::MRNormTwoRegionsBasedFilter::New ( )
static

◆ SetArea1()

virtual void mitk::MRNormTwoRegionsBasedFilter::SetArea1 ( NormalizationBase  _arg)
virtual

◆ SetArea2()

virtual void mitk::MRNormTwoRegionsBasedFilter::SetArea2 ( NormalizationBase  _arg)
virtual

◆ SetMask1()

void mitk::MRNormTwoRegionsBasedFilter::SetMask1 ( const mitk::Image *  mask)

Set the first mask image defining the first reference region.

Parameters
maskThe mask image. Voxels with label 1 are included.

◆ SetMask2()

void mitk::MRNormTwoRegionsBasedFilter::SetMask2 ( const mitk::Image *  mask)

Set the second mask image defining the second reference region.

Parameters
maskThe mask image. Voxels with label 1 are included.

Member Data Documentation

◆ m_Area1

NormalizationBase mitk::MRNormTwoRegionsBasedFilter::m_Area1
protected

Definition at line 93 of file mitkMRNormTwoRegionBasedFilter.h.

◆ m_Area2

NormalizationBase mitk::MRNormTwoRegionsBasedFilter::m_Area2
protected

Definition at line 94 of file mitkMRNormTwoRegionBasedFilter.h.


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