#include <itkPatchBasedDenoisingBaseImageFilter.h>

Detailed Description

template<typename TInputImage, typename TOutputImage>
class itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >

Base class for patch-based denoising algorithms.

Implementation of a denoising filter that uses iterative non-local, or semi-local, weighted averaging of image patches for image denoising. The intensity at each pixel 'p' gets updated as a weighted average of intensities of a chosen subset of pixels from the image. The weights are derived using a kernel function on distances between (i) the patch around pixel p and (ii) the patches around the chosen subset of pixels in the image. This class of methods is motivated by texture-based image models and relies on nonparametric statistical modeling in the high-dimensional space of image patches. The choice of an appropriate kernel bandwidth parameter underlying nonparametric modeling can be important and may be estimated using cross-validation schemes.

Engineering issues underlying this class of methods include the choice of the patch size, the definition of a weighting mask on patches (e.g. to make patches more isotropic and less rectangular), the number of iterations over the image, the scheme for sampling patches from the image, and the weights balancing the regularization and data fidelity when the noise model is known.

This class of methods stems from the following two independent and simultaneous publications:

Suyash P. Awate, Ross T. Whitaker. Higher-Order Image Statistics for Unsupervised, Information-Theoretic, Adaptive, Image Filtering. IEEE Int. Conf. Computer Vision and Pattern Recognition (CVPR) 2005; (2):44-51.

Antoni Buades, Bartomeu Coll, Jean-Michel Morel. A Non-Local Algorithm for Image Denoising. IEEE Int. Conf. Computer Vision and Pattern Recognition (CVPR) 2005; (2):60-65.

While the former work considers the denoising algorithm as performing entropy reduction using nonparametric density estimation, the latter work treats it as nonparametric regression. Details underlying this class of methods appear in:

Suyash P. Awate, Ross T. Whitaker. Unsupervised, Information-Theoretic, Adaptive Image Filtering for Image Restoration. IEEE Transactions on Pattern Analysis and Machine Intelligence (TPAMI) 2006; 28(3):364-376.

Antoni Buades, Bartomeu Coll, Jean-Michel Morel. Nonlocal Image and Movie Denoising. International Journal of Computer Vision (IJCV) 2008; 76(2):123-139.

This class provides the base software framework for implementing patch-based denoising methods for multi-dimensional and multi-channel (i.e. vector-valued pixels) images. This framework is multithreaded on shared-memory architectures. Multithreading is incorporated in, both, intensity-updates and bandwidth-estimation stages by subdividing the image domain and associating each sub-domain to a single thread for processing.

To prevent oversmoothing, this class provides the framework for including a data-fidelity term based on the knowledge of the noise model. The intensity updates are then treated as the sum of (1) the weighted smoothing updates (weighted by SmoothingWeight) and (2) the weighted fidelity updates (weighted by NoiseModelFidelityWeight) that prevent large deviations of the denoised image from the noisy data.

See also: PatchBasedDenoisingImageFilter

Definition at line 145 of file itkPatchBasedDenoisingBaseImageFilter.h.

Inheritance diagram for itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >:

Collaboration diagram for itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >:

Public Types
using	BoundaryConditionType = ZeroFluxNeumannBoundaryCondition< OutputImageType >

using	ComponentSpaceEnum = PatchBasedDenoisingBaseImageFilterEnums::ComponentSpace

using	ConstPointer = SmartPointer< const Self >

using	FilterStateEnum = PatchBasedDenoisingBaseImageFilterEnums::FilterState

using	InputImagePatchIterator = ConstNeighborhoodIterator< InputImageType, BoundaryConditionType >

using	InputImageType = TInputImage

using	InputPixelType = typename InputImageType::PixelType

using	ListAdaptorType = typename itk::Statistics::ImageToNeighborhoodSampleAdaptor< OutputImageType, BoundaryConditionType >

using	NoiseModelEnum = PatchBasedDenoisingBaseImageFilterEnums::NoiseModel

using	OutputImageType = TOutputImage

using	OutputPixelType = typename OutputImageType::PixelType

using	PatchRadiusType = typename ListAdaptorType::NeighborhoodRadiusType

using	PatchWeightsType = Array< float >

using	PixelType = OutputPixelType

using	PixelValueType = typename NumericTraits< PixelType >::ValueType

using	Pointer = SmartPointer< Self >

using	Self = PatchBasedDenoisingBaseImageFilter

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	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	MultiThreaderType = MultiThreaderBase

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

Public Member Functions
virtual const unsigned int &	GetElapsedIterations () const

const char *	GetNameOfClass () const override

PatchRadiusType	GetPatchDiameterInVoxels () const

PatchRadiusType::SizeValueType	GetPatchLengthInVoxels () const

PatchRadiusType	GetPatchRadiusInVoxels () const

PatchWeightsType	GetPatchWeights () const

void	SetPatchWeights (const PatchWeightsType &weights)

virtual void	SetStateToInitialized ()

virtual void	SetStateToUninitialized ()


virtual void	SetPatchRadius (unsigned int _arg)

virtual unsigned int	GetPatchRadius () const


virtual void	SetNoiseModel (const NoiseModelEnum _arg)

virtual NoiseModelEnum	GetNoiseModel () const


virtual void	SetSmoothingWeight (double _arg)

virtual double	GetSmoothingWeight () const


virtual void	SetNoiseModelFidelityWeight (double _arg)

virtual double	GetNoiseModelFidelityWeight () const


virtual void	SetKernelBandwidthEstimation (bool _arg)

virtual void	KernelBandwidthEstimationOn ()

virtual bool	GetKernelBandwidthEstimation () const


virtual void	SetKernelBandwidthUpdateFrequency (unsigned int _arg)

virtual unsigned int	GetKernelBandwidthUpdateFrequency () const


virtual void	SetNumberOfIterations (unsigned int _arg)

virtual const unsigned int &	GetNumberOfIterations () const


virtual void	SetAlwaysTreatComponentsAsEuclidean (bool _arg)

virtual void	AlwaysTreatComponentsAsEuclideanOn ()

virtual bool	GetAlwaysTreatComponentsAsEuclidean () const


virtual void	SetState (const FilterStateEnum _arg)

virtual const FilterStateEnum &	GetState () const


virtual void	SetManualReinitialization (bool _arg)

virtual const bool &	GetManualReinitialization () const

virtual void	ManualReinitializationOn ()

Public Member Functions inherited from itk::ImageToImageFilter< TInputImage, TOutputImage >
const InputImageType *	GetInput () const

const InputImageType *	GetInput (unsigned int idx) const

void	PopBackInput () override

void	PopFrontInput () override

virtual void	PushBackInput (const InputImageType *input)

virtual void	PushFrontInput (const InputImageType *input)

virtual void	SetInput (const DataObjectIdentifierType &key, DataObject *input)

virtual void	SetInput (const InputImageType *input)

virtual void	SetInput (unsigned int, const TInputImage *image)

virtual void	SetCoordinateTolerance (double _arg)

virtual double	GetCoordinateTolerance () const

virtual void	SetDirectionTolerance (double _arg)

virtual double	GetDirectionTolerance () const

Public Member Functions inherited from itk::ImageSource< TOutputImage >
OutputImageType *	GetOutput (unsigned int idx)

OutputImageType *	GetOutput ()

const OutputImageType *	GetOutput () const

virtual void	GraftOutput (DataObject *graft)

virtual void	GraftOutput (const DataObjectIdentifierType &key, DataObject *graft)

virtual void	GraftNthOutput (unsigned int idx, DataObject *graft)

ProcessObject::DataObjectPointer	MakeOutput (ProcessObject::DataObjectPointerArraySizeType idx) override

ProcessObject::DataObjectPointer	MakeOutput (const ProcessObject::DataObjectIdentifierType &) override

Public Member Functions inherited from itk::ProcessObject
virtual void	AbortGenerateDataOn ()

virtual void	EnlargeOutputRequestedRegion (DataObject *)

virtual const bool &	GetAbortGenerateData () const

DataObjectPointerArray	GetIndexedInputs ()

DataObjectPointerArray	GetIndexedOutputs ()

NameArray	GetInputNames () const

DataObjectPointerArray	GetInputs ()

MultiThreaderType *	GetMultiThreader () const

DataObjectPointerArraySizeType	GetNumberOfIndexedInputs () const

DataObjectPointerArraySizeType	GetNumberOfIndexedOutputs () const

DataObjectPointerArraySizeType	GetNumberOfInputs () const

DataObjectPointerArraySizeType	GetNumberOfOutputs () const

virtual DataObjectPointerArraySizeType	GetNumberOfValidRequiredInputs () const

NameArray	GetOutputNames () const

DataObjectPointerArray	GetOutputs ()

virtual float	GetProgress () const

NameArray	GetRequiredInputNames () const

bool	HasInput (const DataObjectIdentifierType &key) const

bool	HasOutput (const DataObjectIdentifierType &key) const

void	IncrementProgress (float increment)

virtual void	PrepareOutputs ()

virtual void	PropagateRequestedRegion (DataObject *output)

virtual void	ResetPipeline ()

virtual void	SetAbortGenerateData (bool _arg)

void	SetMultiThreader (MultiThreaderType *threader)

virtual void	Update ()

virtual void	UpdateLargestPossibleRegion ()

virtual void	UpdateOutputData (DataObject *output)

virtual void	UpdateOutputInformation ()

void	UpdateProgress (float progress)

virtual void	SetReleaseDataFlag (bool val)

virtual bool	GetReleaseDataFlag () const

void	ReleaseDataFlagOn ()

void	ReleaseDataFlagOff ()

virtual void	SetReleaseDataBeforeUpdateFlag (bool _arg)

virtual const bool &	GetReleaseDataBeforeUpdateFlag () const

virtual void	ReleaseDataBeforeUpdateFlagOn ()

virtual void	SetNumberOfWorkUnits (ThreadIdType _arg)

virtual const ThreadIdType &	GetNumberOfWorkUnits () const

Public Member Functions inherited from itk::Object
unsigned long	AddObserver (const EventObject &event, Command *)

unsigned long	AddObserver (const EventObject &event, Command *) const

unsigned long	AddObserver (const EventObject &event, std::function< void(const EventObject &)> function) const

LightObject::Pointer	CreateAnother () const override

virtual void	DebugOff () const

virtual void	DebugOn () const

Command *	GetCommand (unsigned long tag)

bool	GetDebug () const

MetaDataDictionary &	GetMetaDataDictionary ()

const MetaDataDictionary &	GetMetaDataDictionary () const

virtual ModifiedTimeType	GetMTime () const

virtual const TimeStamp &	GetTimeStamp () const

bool	HasObserver (const EventObject &event) const

void	InvokeEvent (const EventObject &)

void	InvokeEvent (const EventObject &) const

virtual void	Modified () const

void	Register () const override

void	RemoveAllObservers ()

void	RemoveObserver (unsigned long tag)

void	SetDebug (bool debugFlag) const

void	SetReferenceCount (int) override

void	UnRegister () const noexcept override

void	SetMetaDataDictionary (const MetaDataDictionary &rhs)

void	SetMetaDataDictionary (MetaDataDictionary &&rrhs)

virtual void	SetObjectName (std::string _arg)

virtual const std::string &	GetObjectName () const

Public Member Functions inherited from itk::LightObject
Pointer	Clone () const

virtual void	Delete ()

virtual int	GetReferenceCount () const

void	Print (std::ostream &os, Indent indent=0) const

Static Public Attributes
static constexpr unsigned int	ImageDimension = InputImageType::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

Protected Member Functions
virtual void	AllocateUpdateBuffer ()=0

virtual void	ApplyUpdate ()=0

virtual void	ComputeImageUpdate ()=0

virtual void	ComputeKernelBandwidthUpdate ()=0

virtual void	CopyInputToOutput ()=0

ComponentSpaceEnum	DetermineComponentSpace (const DiffusionTensor3D< PixelValueType > &)

template<typename PixelT >
ComponentSpaceEnum	DetermineComponentSpace (const PixelT &)

ComponentSpaceEnum	DetermineComponentSpace (const RGBAPixel< PixelValueType > &)

ComponentSpaceEnum	DetermineComponentSpace (const RGBPixel< PixelValueType > &)

void	GenerateData () override

void	GenerateInputRequestedRegion () override

virtual bool	Halt ()

virtual void	Initialize ()

virtual void	InitializeIteration ()

virtual void	InitializePatchWeights ()

	PatchBasedDenoisingBaseImageFilter ()

virtual void	PostProcessOutput ()

virtual void	PreProcessInput ()

void	PrintSelf (std::ostream &os, Indent indent) const override

virtual void	SetElapsedIterations (unsigned int _arg)

virtual bool	ThreadedHalt (void *)

	~PatchBasedDenoisingBaseImageFilter () override=default


virtual void	SetComponentSpace (const ComponentSpaceEnum _arg)

virtual ComponentSpaceEnum	GetComponentSpace () const

Protected Member Functions inherited from itk::ImageToImageFilter< TInputImage, TOutputImage >
virtual void	CallCopyInputRegionToOutputRegion (OutputImageRegionType &destRegion, const InputImageRegionType &srcRegion)

virtual void	CallCopyOutputRegionToInputRegion (InputImageRegionType &destRegion, const OutputImageRegionType &srcRegion)

	ImageToImageFilter ()

void	VerifyInputInformation () ITKv5_CONST override

	~ImageToImageFilter () override=default

virtual void	PushBackInput (const DataObject *input)

virtual void	PushFrontInput (const DataObject *input)

Protected Member Functions inherited from itk::ImageSource< TOutputImage >
virtual void	AfterThreadedGenerateData ()

virtual void	AllocateOutputs ()

virtual void	BeforeThreadedGenerateData ()

void	ClassicMultiThread (ThreadFunctionType callbackFunction)

virtual const ImageRegionSplitterBase *	GetImageRegionSplitter () const

	ImageSource ()

virtual unsigned int	SplitRequestedRegion (unsigned int i, unsigned int pieces, OutputImageRegionType &splitRegion)

	~ImageSource () override=default

virtual void	ThreadedGenerateData (const OutputImageRegionType &region, ThreadIdType threadId)

virtual void	DynamicThreadedGenerateData (const OutputImageRegionType &outputRegionForThread)

virtual bool	GetDynamicMultiThreading () const

virtual void	SetDynamicMultiThreading (bool _arg)

virtual void	DynamicMultiThreadingOn ()

Protected Member Functions inherited from itk::ProcessObject
virtual void	AddInput (DataObject *input)

void	AddOptionalInputName (const DataObjectIdentifierType &)

void	AddOptionalInputName (const DataObjectIdentifierType &, DataObjectPointerArraySizeType idx)

virtual void	AddOutput (DataObject *output)

bool	AddRequiredInputName (const DataObjectIdentifierType &)

bool	AddRequiredInputName (const DataObjectIdentifierType &, DataObjectPointerArraySizeType idx)

virtual void	CacheInputReleaseDataFlags ()

virtual void	GenerateOutputInformation ()

virtual void	GenerateOutputRequestedRegion (DataObject *output)

DataObject *	GetInput (const DataObjectIdentifierType &key)

const DataObject *	GetInput (const DataObjectIdentifierType &key) const

virtual const DataObjectPointerArraySizeType &	GetNumberOfRequiredInputs () const

virtual const DataObjectPointerArraySizeType &	GetNumberOfRequiredOutputs () const

bool	IsIndexedInputName (const DataObjectIdentifierType &) const

bool	IsIndexedOutputName (const DataObjectIdentifierType &) const

bool	IsRequiredInputName (const DataObjectIdentifierType &) const

DataObjectPointerArraySizeType	MakeIndexFromInputName (const DataObjectIdentifierType &name) const

DataObjectPointerArraySizeType	MakeIndexFromOutputName (const DataObjectIdentifierType &name) const

DataObjectIdentifierType	MakeNameFromInputIndex (DataObjectPointerArraySizeType idx) const

DataObjectIdentifierType	MakeNameFromOutputIndex (DataObjectPointerArraySizeType idx) const

	ProcessObject ()

virtual void	PropagateResetPipeline ()

virtual void	PushBackInput (const DataObject *input)

virtual void	PushFrontInput (const DataObject *input)

virtual void	ReleaseInputs ()

virtual void	RemoveInput (const DataObjectIdentifierType &key)

virtual void	RemoveInput (DataObjectPointerArraySizeType)

virtual void	RemoveOutput (const DataObjectIdentifierType &key)

virtual void	RemoveOutput (DataObjectPointerArraySizeType idx)

bool	RemoveRequiredInputName (const DataObjectIdentifierType &)

virtual void	RestoreInputReleaseDataFlags ()

virtual void	SetInput (const DataObjectIdentifierType &key, DataObject *input)

virtual void	SetNthInput (DataObjectPointerArraySizeType idx, DataObject *input)

virtual void	SetNthOutput (DataObjectPointerArraySizeType idx, DataObject *output)

void	SetNumberOfIndexedInputs (DataObjectPointerArraySizeType num)

void	SetNumberOfIndexedOutputs (DataObjectPointerArraySizeType num)

virtual void	SetNumberOfRequiredInputs (DataObjectPointerArraySizeType)

virtual void	SetNumberOfRequiredOutputs (DataObjectPointerArraySizeType _arg)

virtual void	SetOutput (const DataObjectIdentifierType &name, DataObject *output)

virtual void	SetPrimaryInput (DataObject *object)

virtual void	SetPrimaryOutput (DataObject *object)

void	SetRequiredInputNames (const NameArray &)

virtual void	VerifyPreconditions () ITKv5_CONST

	~ProcessObject () override

DataObject *	GetInput (DataObjectPointerArraySizeType idx)

const DataObject *	GetInput (DataObjectPointerArraySizeType idx) const

DataObject *	GetPrimaryInput ()

const DataObject *	GetPrimaryInput () const

virtual void	SetPrimaryInputName (const DataObjectIdentifierType &key)

virtual const char *	GetPrimaryInputName () const

DataObject *	GetOutput (const DataObjectIdentifierType &key)

const DataObject *	GetOutput (const DataObjectIdentifierType &key) const

virtual void	SetPrimaryOutputName (const DataObjectIdentifierType &key)

virtual const char *	GetPrimaryOutputName () const

DataObject *	GetOutput (DataObjectPointerArraySizeType i)

const DataObject *	GetOutput (DataObjectPointerArraySizeType i) const

DataObject *	GetPrimaryOutput ()

const DataObject *	GetPrimaryOutput () const

virtual bool	GetThreaderUpdateProgress () const

virtual void	ThreaderUpdateProgressOn ()

virtual void	SetThreaderUpdateProgress (bool arg)

Protected Member Functions inherited from itk::Object
	Object ()

bool	PrintObservers (std::ostream &os, Indent indent) const

virtual void	SetTimeStamp (const TimeStamp &timeStamp)

	~Object () override

Protected Member Functions inherited from itk::LightObject
virtual LightObject::Pointer	InternalClone () const

	LightObject ()

virtual void	PrintHeader (std::ostream &os, Indent indent) const

virtual void	PrintTrailer (std::ostream &os, Indent indent) const

virtual	~LightObject ()

Protected Attributes
const InputImageType *	m_InputImage {}

OutputImageType *	m_OutputImage {}

Protected Attributes inherited from itk::ImageSource< TOutputImage >
bool	m_DynamicMultiThreading {}

Protected Attributes inherited from itk::ProcessObject
TimeStamp	m_OutputInformationMTime {}

bool	m_Updating {}

Protected Attributes inherited from itk::LightObject
std::atomic< int >	m_ReferenceCount {}

Private Attributes
bool	m_AlwaysTreatComponentsAsEuclidean { false }

ComponentSpaceEnum	m_ComponentSpace { ComponentSpaceEnum::EUCLIDEAN }

unsigned int	m_ElapsedIterations { 0 }

bool	m_KernelBandwidthEstimation { false }

unsigned int	m_KernelBandwidthUpdateFrequency { 3 }

bool	m_ManualReinitialization { false }

NoiseModelEnum	m_NoiseModel { NoiseModelEnum::NOMODEL }

double	m_NoiseModelFidelityWeight { 0.0 }

unsigned int	m_NumberOfIterations { 1 }

unsigned int	m_PatchRadius { 4 }

PatchWeightsType	m_PatchWeights {}

double	m_SmoothingWeight { 1.0 }

FilterStateEnum	m_State { FilterStateEnum::UNINITIALIZED }

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 ()

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
static constexpr float	progressFixedToFloat (uint32_t fixed)

static uint32_t	progressFloatToFixed (float f)

Member Typedef Documentation

◆ BoundaryConditionType

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::BoundaryConditionType = ZeroFluxNeumannBoundaryCondition<OutputImageType>

This data structure type is used for efficiently accessing patch values from the image data structure.

Definition at line 202 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ ComponentSpaceEnum

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::ComponentSpaceEnum = PatchBasedDenoisingBaseImageFilterEnums::ComponentSpace

Definition at line 175 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ ConstPointer

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::ConstPointer = SmartPointer<const Self>

Definition at line 154 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ FilterStateEnum

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::FilterStateEnum = PatchBasedDenoisingBaseImageFilterEnums::FilterState

Definition at line 176 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ InputImagePatchIterator

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::InputImagePatchIterator = ConstNeighborhoodIterator<InputImageType, BoundaryConditionType>

Definition at line 206 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ InputImageType

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::InputImageType = TInputImage

Input and output image types.

Definition at line 160 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ InputPixelType

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::InputPixelType = typename InputImageType::PixelType

Type definition for the input and output pixel types. Output pixel type will be used in computations.

Definition at line 169 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ ListAdaptorType

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::ListAdaptorType = typename itk::Statistics::ImageToNeighborhoodSampleAdaptor<OutputImageType, BoundaryConditionType>

Definition at line 204 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ NoiseModelEnum

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::NoiseModelEnum = PatchBasedDenoisingBaseImageFilterEnums::NoiseModel

Definition at line 174 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ OutputImageType

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::OutputImageType = TOutputImage

Definition at line 161 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ OutputPixelType

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::OutputPixelType = typename OutputImageType::PixelType

Definition at line 170 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ PatchRadiusType

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::PatchRadiusType = typename ListAdaptorType::NeighborhoodRadiusType

Definition at line 205 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ PatchWeightsType

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::PatchWeightsType = Array<float>

This data structure type is used to store the weights (mask) for pixels in a patch in order to make the patch more isotropic and less rectangular.

Definition at line 197 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ PixelType

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::PixelType = OutputPixelType

Definition at line 171 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ PixelValueType

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::PixelValueType = typename NumericTraits<PixelType>::ValueType

Definition at line 172 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ Pointer

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::Pointer = SmartPointer<Self>

Definition at line 153 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ Self

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::Self = PatchBasedDenoisingBaseImageFilter

Standard class type aliases.

Definition at line 151 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ Superclass

template<typename TInputImage , typename TOutputImage >

using itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::Superclass = ImageToImageFilter<TInputImage, TOutputImage>

Definition at line 152 of file itkPatchBasedDenoisingBaseImageFilter.h.

Constructor & Destructor Documentation

◆ PatchBasedDenoisingBaseImageFilter()

template<typename TInputImage , typename TOutputImage >

itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::PatchBasedDenoisingBaseImageFilter ( )

protected

◆ ~PatchBasedDenoisingBaseImageFilter()

template<typename TInputImage , typename TOutputImage >

itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::~PatchBasedDenoisingBaseImageFilter ( )

overrideprotecteddefault

Member Function Documentation

◆ AllocateUpdateBuffer()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::AllocateUpdateBuffer ( )

protectedpure virtual

Allocate memory for a temporary update container in the subclass.

Implemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

◆ AlwaysTreatComponentsAsEuclideanOn()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::AlwaysTreatComponentsAsEuclideanOn ( )

virtual

Set/Get flag indicating whether all components should always be treated as if they are in euclidean space regardless of pixel type. Defaults to false.

◆ ApplyUpdate()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::ApplyUpdate ( )

protectedpure virtual

Implemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

◆ ComputeImageUpdate()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::ComputeImageUpdate ( )

protectedpure virtual

Perform one iteration of image denoising.

Implemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

◆ ComputeKernelBandwidthUpdate()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::ComputeKernelBandwidthUpdate ( )

protectedpure virtual

Automatically estimate kernel bandwidth from the image data.

Implemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

◆ CopyInputToOutput()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::CopyInputToOutput ( )

protectedpure virtual

Implemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

◆ DetermineComponentSpace() [1/4]

template<typename TInputImage , typename TOutputImage >

ComponentSpaceEnum itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::DetermineComponentSpace ( const DiffusionTensor3D< PixelValueType > & )

inlineprotected

Definition at line 402 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ DetermineComponentSpace() [2/4]

template<typename TInputImage , typename TOutputImage >

template<typename PixelT >

ComponentSpaceEnum itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::DetermineComponentSpace ( const PixelT & )

inlineprotected

Definition at line 409 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ DetermineComponentSpace() [3/4]

template<typename TInputImage , typename TOutputImage >

ComponentSpaceEnum itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::DetermineComponentSpace ( const RGBAPixel< PixelValueType > & )

inlineprotected

Definition at line 396 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ DetermineComponentSpace() [4/4]

template<typename TInputImage , typename TOutputImage >

ComponentSpaceEnum itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::DetermineComponentSpace ( const RGBPixel< PixelValueType > & )

inlineprotected

Determine the component space based on pixel type

Definition at line 390 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ GenerateData()

template<typename TInputImage , typename TOutputImage >

void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GenerateData ( )

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.

See also: ThreadedGenerateData()

Reimplemented from itk::ImageSource< TOutputImage >.

◆ GenerateInputRequestedRegion()

template<typename TInputImage , typename TOutputImage >

void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GenerateInputRequestedRegion ( )

overrideprotectedvirtual

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 hierarchy. 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.

See also: ProcessObject::GenerateInputRequestedRegion(), ImageSource::GenerateInputRequestedRegion()

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Reimplemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

◆ GetAlwaysTreatComponentsAsEuclidean()

template<typename TInputImage , typename TOutputImage >

virtual bool itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetAlwaysTreatComponentsAsEuclidean ( ) const

virtual

Set/Get flag indicating whether all components should always be treated as if they are in euclidean space regardless of pixel type. Defaults to false.

◆ GetComponentSpace()

template<typename TInputImage , typename TOutputImage >

virtual ComponentSpaceEnum itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetComponentSpace ( ) const

protectedvirtual

Set/Get the component space type.

◆ GetElapsedIterations()

template<typename TInputImage , typename TOutputImage >

virtual const unsigned int& itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetElapsedIterations ( ) const

virtual

Get the number of elapsed iterations of the filter.

◆ GetKernelBandwidthEstimation()

template<typename TInputImage , typename TOutputImage >

virtual bool itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetKernelBandwidthEstimation ( ) const

virtual

Set/Get flag indicating whether kernel-bandwidth should be estimated automatically from the image data. Defaults to false.

◆ GetKernelBandwidthUpdateFrequency()

template<typename TInputImage , typename TOutputImage >

virtual unsigned int itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetKernelBandwidthUpdateFrequency ( ) const

virtual

Set/Get the update frequency for the kernel bandwidth estimation. An optimal bandwidth will be re-estimated based on the denoised image after every 'n' iterations. Must be a positive integer. Defaults to 3, i.e. bandwidth updated after every 3 denoising iteration.

◆ GetManualReinitialization()

template<typename TInputImage , typename TOutputImage >

virtual const bool& itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetManualReinitialization ( ) const

virtual

Indicates whether the filter automatically resets to UNINITIALIZED state after completing, or whether filter must be manually reset. Require the filter to be manually reinitialized (by calling SetStateToUninitialized().

◆ GetNameOfClass()

template<typename TInputImage , typename TOutputImage >

const char* itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetNameOfClass ( ) const

overridevirtual

See also: LightObject::GetNameOfClass()

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

Reimplemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

◆ GetNoiseModel()

template<typename TInputImage , typename TOutputImage >

virtual NoiseModelEnum itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetNoiseModel ( ) const

virtual

Set/Get the noise model type. Defaults to NOMODEL. To use the noise model during denoising, NoiseModelFidelityWeight must be positive.

◆ GetNoiseModelFidelityWeight()

template<typename TInputImage , typename TOutputImage >

virtual double itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetNoiseModelFidelityWeight ( ) const

virtual

Set/Get the weight on the fidelity term (penalizes deviations from the noisy data). This option is used when a noise model is specified. This weight controls the balance between the smoothing and the closeness to the noisy data. Use a positive weight to prevent oversmoothing.

◆ GetNumberOfIterations()

template<typename TInputImage , typename TOutputImage >

virtual const unsigned int& itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetNumberOfIterations ( ) const

virtual

Set/Get the number of denoising iterations to perform. Must be a positive integer. Defaults to 1.

◆ GetPatchDiameterInVoxels()

template<typename TInputImage , typename TOutputImage >

PatchRadiusType itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetPatchDiameterInVoxels ( ) const

◆ GetPatchLengthInVoxels()

template<typename TInputImage , typename TOutputImage >

PatchRadiusType::SizeValueType itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetPatchLengthInVoxels ( ) const

◆ GetPatchRadius()

template<typename TInputImage , typename TOutputImage >

virtual unsigned int itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetPatchRadius ( ) const

virtual

Set/Get the patch radius specified in physical coordinates. Patch radius is preferably set to an even number. Currently, only isotropic patches in physical space are allowed; patches can be anisotropic in voxel space.

◆ GetPatchRadiusInVoxels()

template<typename TInputImage , typename TOutputImage >

PatchRadiusType itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetPatchRadiusInVoxels ( ) const

◆ GetPatchWeights()

template<typename TInputImage , typename TOutputImage >

PatchWeightsType itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetPatchWeights ( ) const

◆ GetSmoothingWeight()

template<typename TInputImage , typename TOutputImage >

virtual double itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetSmoothingWeight ( ) const

virtual

Set/Get the weight on the smoothing term. This option is used when a noise model is specified. This weight controls the balance between the smoothing and the closeness to the noisy data. Large step sizes may cause instabilities.

◆ GetState()

template<typename TInputImage , typename TOutputImage >

virtual const FilterStateEnum& itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::GetState ( ) const

virtual

Set/Get the state of the filter.

◆ Halt()

template<typename TInputImage , typename TOutputImage >

virtual bool itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::Halt ( )

protectedvirtual

Check and indicate whether to continue iterations or stop.

◆ Initialize()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::Initialize ( )

inlineprotectedvirtual

Reimplemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

Definition at line 346 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ InitializeIteration()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::InitializeIteration ( )

inlineprotectedvirtual

Reimplemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

Definition at line 358 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ InitializePatchWeights()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::InitializePatchWeights ( )

protectedvirtual

Allocate memory and initialize patch weights.

Reimplemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

◆ KernelBandwidthEstimationOn()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::KernelBandwidthEstimationOn ( )

virtual

Set/Get flag indicating whether kernel-bandwidth should be estimated automatically from the image data. Defaults to false.

◆ ManualReinitializationOn()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::ManualReinitializationOn ( )

virtual

Indicates whether the filter automatically resets to UNINITIALIZED state after completing, or whether filter must be manually reset. Require the filter to be manually reinitialized (by calling SetStateToUninitialized().

◆ PostProcessOutput()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::PostProcessOutput ( )

inlineprotectedvirtual

Reimplemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

Definition at line 373 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ PreProcessInput()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::PreProcessInput ( )

inlineprotectedvirtual

Definition at line 354 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ PrintSelf()

template<typename TInputImage , typename TOutputImage >

void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::PrintSelf	(	std::ostream &	os,
		Indent	indent
	)		const

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 >.

Reimplemented in itk::PatchBasedDenoisingImageFilter< TInputImage, TOutputImage >.

◆ SetAlwaysTreatComponentsAsEuclidean()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetAlwaysTreatComponentsAsEuclidean ( bool _arg )

virtual

Set/Get flag indicating whether all components should always be treated as if they are in euclidean space regardless of pixel type. Defaults to false.

◆ SetComponentSpace()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetComponentSpace ( const ComponentSpaceEnum _arg )

protectedvirtual

Set/Get the component space type.

◆ SetElapsedIterations()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetElapsedIterations ( unsigned int _arg )

protectedvirtual

◆ SetKernelBandwidthEstimation()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetKernelBandwidthEstimation ( bool _arg )

virtual

Set/Get flag indicating whether kernel-bandwidth should be estimated automatically from the image data. Defaults to false.

◆ SetKernelBandwidthUpdateFrequency()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetKernelBandwidthUpdateFrequency ( unsigned int _arg )

virtual

Set/Get the update frequency for the kernel bandwidth estimation. An optimal bandwidth will be re-estimated based on the denoised image after every 'n' iterations. Must be a positive integer. Defaults to 3, i.e. bandwidth updated after every 3 denoising iteration.

◆ SetManualReinitialization()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetManualReinitialization ( bool _arg )

virtual

Indicates whether the filter automatically resets to UNINITIALIZED state after completing, or whether filter must be manually reset. Require the filter to be manually reinitialized (by calling SetStateToUninitialized().

◆ SetNoiseModel()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetNoiseModel ( const NoiseModelEnum _arg )

virtual

Set/Get the noise model type. Defaults to NOMODEL. To use the noise model during denoising, NoiseModelFidelityWeight must be positive.

◆ SetNoiseModelFidelityWeight()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetNoiseModelFidelityWeight ( double _arg )

virtual

Set/Get the weight on the fidelity term (penalizes deviations from the noisy data). This option is used when a noise model is specified. This weight controls the balance between the smoothing and the closeness to the noisy data. Use a positive weight to prevent oversmoothing.

◆ SetNumberOfIterations()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetNumberOfIterations ( unsigned int _arg )

virtual

Set/Get the number of denoising iterations to perform. Must be a positive integer. Defaults to 1.

◆ SetPatchRadius()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetPatchRadius ( unsigned int _arg )

virtual

Set/Get the patch radius specified in physical coordinates. Patch radius is preferably set to an even number. Currently, only isotropic patches in physical space are allowed; patches can be anisotropic in voxel space.

◆ SetPatchWeights()

template<typename TInputImage , typename TOutputImage >

void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetPatchWeights ( const PatchWeightsType & weights )

Set/Get the patch weights, or mask, that make the patch more isotropic (less rectangular). This function allows the user to set arbitrary patch weights by providing a 1-D array of weights.

◆ SetSmoothingWeight()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetSmoothingWeight ( double _arg )

virtual

Set/Get the weight on the smoothing term. This option is used when a noise model is specified. This weight controls the balance between the smoothing and the closeness to the noisy data. Large step sizes may cause instabilities.

◆ SetState()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetState ( const FilterStateEnum _arg )

virtual

Set/Get the state of the filter.

◆ SetStateToInitialized()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetStateToInitialized ( )

virtual

Set the state of the filter to INITIALIZED.

◆ SetStateToUninitialized()

template<typename TInputImage , typename TOutputImage >

virtual void itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::SetStateToUninitialized ( )

virtual

Set the state of the filter to UNINITIALIZED.

◆ ThreadedHalt()

template<typename TInputImage , typename TOutputImage >

virtual bool itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::ThreadedHalt ( void * )

inlineprotectedvirtual

Definition at line 381 of file itkPatchBasedDenoisingBaseImageFilter.h.

Member Data Documentation

◆ ImageDimension

template<typename TInputImage , typename TOutputImage >

constexpr unsigned int itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::ImageDimension = InputImageType::ImageDimension

staticconstexpr

Image dimension, assumed to be the same for input and output data.

Definition at line 164 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_AlwaysTreatComponentsAsEuclidean

template<typename TInputImage , typename TOutputImage >

bool itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_AlwaysTreatComponentsAsEuclidean { false }

private

Parameter indicating whether components should be treated as if they are in Euclidean space regardless of pixel type.

Definition at line 445 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_ComponentSpace

template<typename TInputImage , typename TOutputImage >

ComponentSpaceEnum itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_ComponentSpace { ComponentSpaceEnum::EUCLIDEAN }

private

Definition at line 446 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_ElapsedIterations

template<typename TInputImage , typename TOutputImage >

unsigned int itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_ElapsedIterations { 0 }

private

Definition at line 436 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_InputImage

template<typename TInputImage , typename TOutputImage >

const InputImageType* itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_InputImage {}

protected

Definition at line 421 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_KernelBandwidthEstimation

template<typename TInputImage , typename TOutputImage >

bool itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_KernelBandwidthEstimation { false }

private

Parameters that define the strategy for kernel-bandwidth estimation.

Definition at line 430 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_KernelBandwidthUpdateFrequency

template<typename TInputImage , typename TOutputImage >

unsigned int itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_KernelBandwidthUpdateFrequency { 3 }

private

Definition at line 431 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_ManualReinitialization

template<typename TInputImage , typename TOutputImage >

bool itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_ManualReinitialization { false }

private

Definition at line 448 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_NoiseModel

template<typename TInputImage , typename TOutputImage >

NoiseModelEnum itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_NoiseModel { NoiseModelEnum::NOMODEL }

private

Parameters defining the usage of a specific noise model, if desired.

Definition at line 439 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_NoiseModelFidelityWeight

template<typename TInputImage , typename TOutputImage >

double itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_NoiseModelFidelityWeight { 0.0 }

private

Definition at line 441 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_NumberOfIterations

template<typename TInputImage , typename TOutputImage >

unsigned int itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_NumberOfIterations { 1 }

private

Parameters that define the total number of denoising iterations to perform and those completed so far.

Definition at line 435 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_OutputImage

template<typename TInputImage , typename TOutputImage >

OutputImageType* itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_OutputImage {}

protected

Definition at line 422 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_PatchRadius

template<typename TInputImage , typename TOutputImage >

unsigned int itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_PatchRadius { 4 }

private

Parameters that define patch size and patch weights (mask).

Definition at line 426 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_PatchWeights

template<typename TInputImage , typename TOutputImage >

PatchWeightsType itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_PatchWeights {}

private

Definition at line 427 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_SmoothingWeight

template<typename TInputImage , typename TOutputImage >

double itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_SmoothingWeight { 1.0 }

private

Definition at line 440 of file itkPatchBasedDenoisingBaseImageFilter.h.

◆ m_State

template<typename TInputImage , typename TOutputImage >

FilterStateEnum itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >::m_State { FilterStateEnum::UNINITIALIZED }

private

Definition at line 450 of file itkPatchBasedDenoisingBaseImageFilter.h.

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

itkPatchBasedDenoisingBaseImageFilter.h

Detailed Description

template<typename TInputImage, typename TOutputImage> class itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >

Public Types

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Private Attributes

Additional Inherited Members

Member Typedef Documentation

◆ BoundaryConditionType

◆ ComponentSpaceEnum

◆ ConstPointer

◆ FilterStateEnum

◆ InputImagePatchIterator

◆ InputImageType

◆ InputPixelType

◆ ListAdaptorType

◆ NoiseModelEnum

◆ OutputImageType

◆ OutputPixelType

◆ PatchRadiusType

◆ PatchWeightsType

◆ PixelType

◆ PixelValueType

◆ Pointer

◆ Self

◆ Superclass

Constructor & Destructor Documentation

◆ PatchBasedDenoisingBaseImageFilter()

◆ ~PatchBasedDenoisingBaseImageFilter()

Member Function Documentation

◆ AllocateUpdateBuffer()

◆ AlwaysTreatComponentsAsEuclideanOn()

◆ ApplyUpdate()

◆ ComputeImageUpdate()

◆ ComputeKernelBandwidthUpdate()

◆ CopyInputToOutput()

◆ DetermineComponentSpace() [1/4]

◆ DetermineComponentSpace() [2/4]

◆ DetermineComponentSpace() [3/4]

◆ DetermineComponentSpace() [4/4]

◆ GenerateData()

◆ GenerateInputRequestedRegion()

◆ GetAlwaysTreatComponentsAsEuclidean()

◆ GetComponentSpace()

◆ GetElapsedIterations()

◆ GetKernelBandwidthEstimation()

◆ GetKernelBandwidthUpdateFrequency()

◆ GetManualReinitialization()

◆ GetNameOfClass()

◆ GetNoiseModel()

◆ GetNoiseModelFidelityWeight()

◆ GetNumberOfIterations()

◆ GetPatchDiameterInVoxels()

◆ GetPatchLengthInVoxels()

◆ GetPatchRadius()

◆ GetPatchRadiusInVoxels()

◆ GetPatchWeights()

◆ GetSmoothingWeight()

◆ GetState()

◆ Halt()

◆ Initialize()

◆ InitializeIteration()

◆ InitializePatchWeights()

◆ KernelBandwidthEstimationOn()

◆ ManualReinitializationOn()

◆ PostProcessOutput()

◆ PreProcessInput()

◆ PrintSelf()

◆ SetAlwaysTreatComponentsAsEuclidean()

◆ SetComponentSpace()

◆ SetElapsedIterations()

◆ SetKernelBandwidthEstimation()

◆ SetKernelBandwidthUpdateFrequency()

◆ SetManualReinitialization()

◆ SetNoiseModel()

◆ SetNoiseModelFidelityWeight()

◆ SetNumberOfIterations()

◆ SetPatchRadius()

template<typename TInputImage, typename TOutputImage>
class itk::PatchBasedDenoisingBaseImageFilter< TInputImage, TOutputImage >