/*========================================================================= * * Copyright Insight Software Consortium * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0.txt * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * *=========================================================================*/ #ifndef itkLevelSetEquationCurvatureTerm_h #define itkLevelSetEquationCurvatureTerm_h #include "itkLevelSetEquationTermBase.h" #include "itkZeroFluxNeumannBoundaryCondition.h" #include "itkConstNeighborhoodIterator.h" #include "itkVector.h" #include "vnl/vnl_matrix_fixed.h" namespace itk { /** * \class LevelSetEquationCurvatureTerm * \brief Derived class to represents a curvature term in the level-set evolution PDE * * \f[ * CurvatureImage( p ) \cdot \kappa( p ) * \f] * * \li CurvatureImage denotes the curvature image set by the user * \li \f$ \kappa( p ) \f$ denotes the mean curvature of the level set function, * i.e. \f$ \kappa( p ) = \text{div} \left( \frac{ \nabla \phi( p ) }{ \left\| \nabla \phi(p) \right\| } \right) \f$ * * \tparam TInput Input Image Type * \tparam TLevelSetContainer Level set function container type * \ingroup ITKLevelSetsv4 */ template< typename TInput, // Input image or mesh typename TLevelSetContainer, typename TCurvatureImage = TInput > class ITK_TEMPLATE_EXPORT LevelSetEquationCurvatureTerm : public LevelSetEquationTermBase< TInput, TLevelSetContainer > { public: typedef LevelSetEquationCurvatureTerm Self; typedef SmartPointer< Self > Pointer; typedef SmartPointer< const Self > ConstPointer; typedef LevelSetEquationTermBase< TInput, TLevelSetContainer > Superclass; /** Method for creation through object factory */ itkNewMacro( Self ); /** Run-time type information */ itkTypeMacro( LevelSetEquationCurvatureTerm, LevelSetEquationTermBase ); typedef typename Superclass::InputImageType InputImageType; typedef typename Superclass::InputImagePointer InputImagePointer; typedef typename Superclass::InputPixelType InputPixelType; typedef typename Superclass::InputPixelRealType InputPixelRealType; typedef typename Superclass::LevelSetContainerType LevelSetContainerType; typedef typename Superclass::LevelSetContainerPointer LevelSetContainerPointer; typedef typename Superclass::LevelSetType LevelSetType; typedef typename Superclass::LevelSetPointer LevelSetPointer; typedef typename Superclass::LevelSetOutputPixelType LevelSetOutputPixelType; typedef typename Superclass::LevelSetOutputRealType LevelSetOutputRealType; typedef typename Superclass::LevelSetInputIndexType LevelSetInputIndexType; typedef typename Superclass::LevelSetGradientType LevelSetGradientType; typedef typename Superclass::LevelSetHessianType LevelSetHessianType; typedef typename Superclass::LevelSetIdentifierType LevelSetIdentifierType; typedef typename Superclass::HeavisideType HeavisideType; typedef typename Superclass::HeavisideConstPointer HeavisideConstPointer; typedef typename Superclass::LevelSetDataType LevelSetDataType; itkStaticConstMacro(ImageDimension, unsigned int, InputImageType::ImageDimension); typedef TCurvatureImage CurvatureImageType; typedef typename CurvatureImageType::Pointer CurvatureImagePointer; /** Set/Get the propagation image. By default, if no PropagationImage has been set, it casts the input image and uses it in the term contribution calculation. */ void SetCurvatureImage( CurvatureImageType* CurvatureImage ); itkGetModifiableObjectMacro(CurvatureImage, CurvatureImageType ); itkSetMacro( UseCurvatureImage, bool ); itkGetMacro( UseCurvatureImage, bool ); itkBooleanMacro( UseCurvatureImage ); /** Neighborhood radius type */ typedef ZeroFluxNeumannBoundaryCondition< InputImageType > DefaultBoundaryConditionType; typedef typename ConstNeighborhoodIterator< InputImageType >::RadiusType RadiusType; typedef ConstNeighborhoodIterator< InputImageType, DefaultBoundaryConditionType > NeighborhoodType; typedef Vector< LevelSetOutputRealType, itkGetStaticConstMacro(ImageDimension) > NeighborhoodScalesType; /** Update the term parameter values at end of iteration */ virtual void Update() ITK_OVERRIDE; /** Initialize the parameters in the terms prior to an iteration */ virtual void InitializeParameters() ITK_OVERRIDE; /** Initialize term parameters in the dense case by computing for each pixel location */ virtual void Initialize( const LevelSetInputIndexType& ) ITK_OVERRIDE; /** Supply updates at pixels to keep the term parameters always updated */ virtual void UpdatePixel( const LevelSetInputIndexType& iP, const LevelSetOutputRealType& oldValue, const LevelSetOutputRealType& newValue ) ITK_OVERRIDE; protected: LevelSetEquationCurvatureTerm(); virtual ~LevelSetEquationCurvatureTerm() ITK_OVERRIDE; /** Returns the term contribution for a given location iP, i.e. * \f$ \omega_i( p ) \f$. */ virtual LevelSetOutputRealType Value( const LevelSetInputIndexType& iP ) ITK_OVERRIDE; /** Returns the term contribution for a given location iP, i.e. * \f$ \omega_i( p ) \f$. */ virtual LevelSetOutputRealType Value( const LevelSetInputIndexType& iP, const LevelSetDataType& iData ) ITK_OVERRIDE; LevelSetOutputRealType m_NeighborhoodScales[ImageDimension]; CurvatureImagePointer m_CurvatureImage; bool m_UseCurvatureImage; private: ITK_DISALLOW_COPY_AND_ASSIGN(LevelSetEquationCurvatureTerm); }; } #ifndef ITK_MANUAL_INSTANTIATION #include "itkLevelSetEquationCurvatureTerm.hxx" #endif #endif