1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122
|
/*=========================================================================
Program: Insight Segmentation & Registration Toolkit
Module: $RCSfile: itkVectorCurvatureAnisotropicDiffusionImageFilter.h,v $
Language: C++
Date: $Date: 2006-04-03 15:07:52 $
Version: $Revision: 1.18 $
Copyright (c) Insight Software Consortium. All rights reserved.
See ITKCopyright.txt or http://www.itk.org/HTML/Copyright.htm for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notices for more information.
=========================================================================*/
#ifndef __itkVectorCurvatureAnisotropicDiffusionImageFilter_h_
#define __itkVectorCurvatureAnisotropicDiffusionImageFilter_h_
#include "itkExceptionObject.h"
#include "itkAnisotropicDiffusionImageFilter.h"
#include "itkVectorCurvatureNDAnisotropicDiffusionFunction.h"
namespace itk {
/** \class VectorCurvatureAnisotropicDiffusionImageFilter
*
* This filter performs anisotropic diffusion on a vector itk::Image using the
* modified curvature diffusion equation (MCDE) implemented in
* itkVectorCurvatureNDAnisotropicDiffusionFunction. For detailed information on
* anisotropic diffusion and the MCDE see itkAnisotropicDiffusionFunction,
* itkVectorCurvatureNDAnisotropicDiffusionFunction, and
* itkCurvatureNDAnisotropicDiffusionFunction.
*
* \par Inputs and Outputs
* The input to this filter must be an itk::Image with pixel
* type which is either an itk::Vector, or a subclass of an itk::Vector.
* Additionally, the component type of the vector should be a numerical type
* (float or double, or a user defined type which correctly defines
* arithmetic operations with floating point accuracy). The output image type
* also has these requirements.
*
* \par Parameters
* Please first read all the documentation found in
* AnisotropicDiffusionImageFilter and AnisotropicDiffusionFunction. Also see
* VectorCurvatureNDAnisotropicDiffusionFunction.
*
* The default time step for this filter is set to the maximum theoretically
* stable value: 0.5 / 2^N, where N is the dimensionality of the image. For a
* 2D image, this means valid time steps are below 0.1250. For a 3D image,
* valid time steps are below 0.0625.
*
* \sa AnisotropicDiffusionImageFilter
* \sa AnisotropicDiffusionFunction
* \sa CurvatureNDAnisotropicDiffusionFunction
* \ingroup ImageEnhancement
*
*/
template <class TInputImage, class TOutputImage>
class ITK_EXPORT VectorCurvatureAnisotropicDiffusionImageFilter
: public AnisotropicDiffusionImageFilter<TInputImage, TOutputImage>
{
public:
/** Standard itk typedefs */
typedef VectorCurvatureAnisotropicDiffusionImageFilter Self;
typedef AnisotropicDiffusionImageFilter<TInputImage, TOutputImage>
Superclass;
typedef SmartPointer<Self> Pointer;
typedef SmartPointer<const Self> ConstPointer;
/** Instantiation through object factory. */
itkNewMacro(Self);
/** Run-time type information. */
itkTypeMacro(VectorCurvatureAnisotropicDiffusionImageFilter,
AnisotropicDiffusionImageFilter);
/** Convenient typedef. */
typedef typename Superclass::UpdateBufferType UpdateBufferType;
/** Determine the image dimension. */
itkStaticConstMacro(ImageDimension, unsigned int,
Superclass::ImageDimension );
#ifdef ITK_USE_CONCEPT_CHECKING
/** Begin concept checking */
itkConceptMacro(InputHasNumericTraitsCheck,
(Concept::HasNumericTraits<typename TInputImage::PixelType::ValueType>));
itkConceptMacro(OutputHasNumericTraitsCheck,
(Concept::HasNumericTraits<typename TOutputImage::PixelType::ValueType>));
/** End concept checking */
#endif
protected:
VectorCurvatureAnisotropicDiffusionImageFilter()
{
typename VectorCurvatureNDAnisotropicDiffusionFunction<UpdateBufferType>::Pointer q
= VectorCurvatureNDAnisotropicDiffusionFunction<UpdateBufferType>::New();
this->SetDifferenceFunction(q);
}
~VectorCurvatureAnisotropicDiffusionImageFilter() {}
virtual void InitializeIteration()
{
Superclass::InitializeIteration();
if (this->GetTimeStep() > 0.5 / vcl_pow(2.0, static_cast<double>(ImageDimension)) )
{
itkWarningMacro(<< "Anisotropic diffusion has attempted to use a time step which may introduce instability into the solution." );
}
}
void PrintSelf(std::ostream& os, Indent indent) const
{ Superclass::PrintSelf(os,indent); }
private:
VectorCurvatureAnisotropicDiffusionImageFilter(const Self&); //purposely not implemented
void operator=(const Self&); //purposely not implemented
};
} // end namspace itk
#endif
|