itkFrangiTubularnessImageFilter.h

Go to the documentation of this file.

/*=========================================================================

  Program:   Insight Segmentation & Registration Toolkit
  Module:    itkFrangiTubularnessImageFilter.h
  Language:  C++
  Date:      $Date$
  Version:   $Revision$

  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 itkFrangiTubularnessImageFilter_h
#define itkFrangiTubularnessImageFilter_h

#include "itkUnaryFunctorImageFilter.h"
#include "itkMath.h"

namespace itk
{

namespace Function {

template< typename TInput, typename TOutput>
class Tubularness
{
public:
  Tubularness()
    {
    m_Alpha  = 0.5; // suggested value in the paper
    m_Beta   = 0.5; // suggested value in the paper;
    m_Gamma  = 1.0; // suggested value in the paper;
    m_BrigthForeground = true;
    }
  ~Tubularness() {}
  Tubularness( const Tubularness & one )
    {
    this->m_Alpha = one.m_Alpha;
    this->m_Beta = one.m_Beta;
    this->m_Gamma = one.m_Gamma;
    this->m_BrigthForeground = one.m_BrigthForeground;
    }
  const Tubularness & operator=( const Tubularness & one )
    {
    this->m_Alpha = one.m_Alpha;
    this->m_Beta = one.m_Beta;
    this->m_Gamma = one.m_Gamma;
    this->m_BrigthForeground = one.m_BrigthForeground;
    return *this;
    }
  bool operator!=( const Tubularness & ) const
    {
    return false;
    }
  bool operator==( const Tubularness & other ) const
    {
    return !(*this != other);
    }
  inline TOutput operator()( const TInput & A )
    {
    double tubularness = 0.0;

    auto a1 = static_cast<double>( A[0] );
    auto a2 = static_cast<double>( A[1] );
    auto a3 = static_cast<double>( A[2] );

    double l1 = itk::Math::abs( a1 );
    double l2 = itk::Math::abs( a2 );
    double l3 = itk::Math::abs( a3 );

    //
    // Sort the values by their absolute value.
    //
    if( l2 > l3 )
      {
      double tmpl = l3;
      l3 = l2;
      l2 = tmpl;
      double tmpa = a3;
      a3 = a2;
      a2 = tmpa;
      }

    if( l1 > l2 )
      {
      double tmp = l1;
      l1 = l2;
      l2 = tmp;
      double tmpa = a1;
      a1 = a2;
      a2 = tmpa;
      }

    if( l2 > l3 )
      {
      double tmp = l3;
      l3 = l2;
      l2 = tmp;
      double tmpa = a3;
      a3 = a2;
      a2 = tmpa;
      }

    if( m_BrigthForeground )
      {
      //
      // Reject dark tubes and dark ridges over bright background
      //
      if( a3 > 0.0 )
        {
        return tubularness;
        }
      }
    else
      {
      //
      // Reject bright tubes and bright ridges over dark background
      //
      if( a3 < 0.0 )
        {
        return tubularness;
        }
      }

    // avoid divisions by zero
    if( l2 < itk::Math::eps || l3 < itk::Math::eps )
      {
      return tubularness;
      }

    const double Rs = l2 / l3;
    const double Rb = l1 / std::sqrt( l2 * l3 );
    const double Rn = std::sqrt( l3*l3 + l2*l2 + l1*l1 );

    tubularness  = ( 1.0 - std::exp( - ( Rs * Rs ) / ( 2.0 * m_Alpha * m_Alpha ) ) );
    tubularness *= (       std::exp( - ( Rb * Rb ) / ( 2.0 * m_Beta  * m_Beta  ) ) );
    tubularness *= ( 1.0 - std::exp( - ( Rn * Rn ) / ( 2.0 * m_Gamma * m_Gamma ) ) );

    return static_cast<TOutput>( tubularness );
    }

  void SetAlpha( double value )
    {
    this->m_Alpha = value;
    }
  void SetBeta( double value )
    {
    this->m_Beta = value;
    }
  void SetGamma( double value )
    {
    this->m_Gamma = value;
    }
  void SetBrightBackground( bool value )
    {
    std::cout << "m_BrigthForeground " << value << std::endl;
    this->m_BrigthForeground;
    }

private:
  double m_Alpha;
  double m_Beta;
  double m_Gamma;
  bool   m_BrigthForeground;
};
}

template <typename TInputImage, typename TOutputImage>
class ITK_TEMPLATE_EXPORT FrangiTubularnessImageFilter :
    public
UnaryFunctorImageFilter<TInputImage,TOutputImage,
                        Function::Tubularness< typename TInputImage::PixelType,
                                       typename TOutputImage::PixelType>   >
{
public:
  ITK_DISALLOW_COPY_AND_ASSIGN(FrangiTubularnessImageFilter);

  using Self = FrangiTubularnessImageFilter;
  using Superclass = UnaryFunctorImageFilter<
    TInputImage,TOutputImage,
    Function::Tubularness<
      typename TInputImage::PixelType,
      typename TOutputImage::PixelType> >;
  using Pointer = SmartPointer<Self>;
  using ConstPointer = SmartPointer<const Self>;

  itkNewMacro(Self);

  itkTypeMacro(FrangiTubularnessImageFilter,
               UnaryFunctorImageFilter);

  void SetSheetnessNormalization( double value )
    {
    this->GetFunctor().SetAlpha( value );
    }

  void SetBloobinessNormalization( double value )
    {
    this->GetFunctor().SetBeta( value );
    }

  void SetNoiseNormalization( double value )
    {
    this->GetFunctor().SetGamma( value );
    }

  void SetBrightBackground( bool value )
    {
    this->GetFunctor().SetBrightBackground( value );
    }


#ifdef ITK_USE_CONCEPT_CHECKING

  using InputPixelType = typename TInputImage::PixelType;
  itkConceptMacro(BracketOperatorsCheck,
    (Concept::BracketOperator< InputPixelType, unsigned int, double >));
  itkConceptMacro(DoubleConvertibleToOutputCheck,
    (Concept::Convertible<double, typename TOutputImage::PixelType>));

#endif

protected:
  FrangiTubularnessImageFilter() {}
  ~FrangiTubularnessImageFilter() override {}
};

} // end namespace itk


#endif