itkBSplineKernelFunction2.h

Go to the documentation of this file.

/*=========================================================================
 *
 *  Copyright UMC Utrecht and contributors
 *
 *  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.
 *
 *=========================================================================*/
/*=========================================================================
 
  Program:   Insight Segmentation & Registration Toolkit
  Module:    $RCSfile: itkBSplineKernelFunction.h,v $
  Language:  C++
  Date:      $Date: 2006-03-18 20:13:35 $
  Version:   $Revision: 1.7 $
 
  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 __itkBSplineKernelFunction2_h
#define __itkBSplineKernelFunction2_h
 
#include "itkKernelFunctionBase2.h"
#include "vnl/vnl_math.h"
 
namespace itk
{
 
template< unsigned int VSplineOrder = 3 >
class ITK_EXPORT BSplineKernelFunction2 : public KernelFunctionBase2< double >
{
public:
 
  typedef BSplineKernelFunction2        Self;
  typedef KernelFunctionBase2< double > Superclass;
  typedef SmartPointer< Self >          Pointer;
 
  itkNewMacro( Self );
 
  itkTypeMacro( BSplineKernelFunction2, KernelFunctionBase2 );
 
  itkStaticConstMacro( SplineOrder, unsigned int, VSplineOrder );
 
  typedef FixedArray< double,
    itkGetStaticConstMacro( SplineOrder ) + 1 >  WeightArrayType;
 
  inline double Evaluate( const double & u ) const override
  {
    return this->Evaluate( Dispatch< VSplineOrder >(), u );
  }
 
 
  inline void Evaluate( const double & u, double * weights ) const override
  {
    this->Evaluate( Dispatch< VSplineOrder >(), u, weights );
  }
 
 
protected:
 
  BSplineKernelFunction2(){}
  ~BSplineKernelFunction2() override{}
 
  void PrintSelf( std::ostream & os, Indent indent ) const override
  {
    Superclass::PrintSelf( os, indent );
    os << indent << "Spline Order: " << SplineOrder << std::endl;
  }
 
 
private:
 
  BSplineKernelFunction2( const Self & ); // purposely not implemented
  void operator=( const Self & );         // purposely not implemented
 
  struct DispatchBase {};
  template< unsigned int >
  struct Dispatch : DispatchBase {};
 
  inline double Evaluate( const Dispatch< 0 > &, const double & u ) const
  {
    const double absValue = std::abs( u );
 
    if( absValue < 0.5 ) { return NumericTraits< double >::OneValue(); }
    else if( absValue == 0.5 ) { return 0.5; }
    else { return NumericTraits< double >::ZeroValue(); }
  }
 
 
  inline double Evaluate( const Dispatch< 1 > &, const double & u ) const
  {
    const double absValue = std::abs( u );
 
    if( absValue < 1.0 ) { return NumericTraits< double >::OneValue() - absValue; }
    else { return NumericTraits< double >::ZeroValue(); }
  }
 
 
  inline double Evaluate( const Dispatch< 2 > &, const double & u ) const
  {
    const double absValue = std::abs( u );
 
    if( absValue < 0.5 )
    {
      return 0.75 - absValue * absValue;
    }
    else if( absValue < 1.5 )
    {
      return ( 9.0 - 12.0 * absValue + 4.0 * absValue * absValue ) / 8.0;
    }
    else { return NumericTraits< double >::ZeroValue(); }
  }
 
 
  inline double Evaluate( const Dispatch< 3 > &, const double & u ) const
  {
    const double absValue = std::abs( u );
    const double sqrValue = u * u;
 
    if( absValue < 1.0 )
    {
      return ( 4.0 - 6.0 * sqrValue + 3.0 * sqrValue * absValue ) / 6.0;
    }
    else if( absValue < 2.0 )
    {
      return ( 8.0 - 12.0 * absValue + 6.0 * sqrValue - sqrValue * absValue ) / 6.0;
    }
    else { return NumericTraits< double >::ZeroValue(); }
  }
 
 
  inline double Evaluate( const DispatchBase &, const double & ) const
  {
    itkExceptionMacro( << "Evaluate not implemented for spline order " << SplineOrder );
    return 0.0;
  }
 
 
  inline void Evaluate( const Dispatch< 0 > &, const double & u,
    double * weights ) const
  {
    const double absValue = std::abs( u );
 
    if( absValue < 0.5 ) { weights[ 0 ] = NumericTraits< double >::OneValue(); }
    else if( absValue == 0.5 ) { weights[ 0 ] = 0.5; }
    else { weights[ 0 ] = NumericTraits< double >::ZeroValue(); }
  }
 
 
  inline void Evaluate( const Dispatch< 1 > &, const double & u,
    double * weights ) const
  {
    const double absValue = std::abs( u );
 
    weights[ 0 ] = NumericTraits< double >::OneValue() - absValue;
    weights[ 1 ] = absValue;
  }
 
 
  inline void Evaluate( const Dispatch< 2 > &, const double & u,
    double * weights ) const
  {
    const double absValue = std::abs( u );
    const double sqrValue = u * u;
 
    weights[ 0 ] = ( 9.0 - 12.0 * absValue + 4.0 * sqrValue ) / 8.0;
    weights[ 1 ] = -0.25 + 2.0 * absValue - sqrValue;
    weights[ 2 ] = ( 1.0 - 4.0 * absValue + 4.0 * sqrValue ) / 8.0;
  }
 
 
  inline void Evaluate( const Dispatch< 3 > &, const double & u,
    double * weights ) const
  {
    const double absValue = std::abs( u );
    const double sqrValue = u * u;
    const double uuu = sqrValue * absValue;
 
    // Use (numerically) slightly less accurate multiplication with 1/6
    // instead of division by 6 to substantially improve speed.
    static const double onesixth = 1.0 / 6.0;
    weights[ 0 ] = (  8.0 - 12.0 * absValue +  6.0 * sqrValue -       uuu ) * onesixth;
    weights[ 1 ] = ( -5.0 + 21.0 * absValue - 15.0 * sqrValue + 3.0 * uuu ) * onesixth;
    weights[ 2 ] = (  4.0 - 12.0 * absValue + 12.0 * sqrValue - 3.0 * uuu ) * onesixth;
    weights[ 3 ] = ( -1.0 +  3.0 * absValue -  3.0 * sqrValue +       uuu ) * onesixth;
  }
 
 
  inline double Evaluate( const DispatchBase &, const double &, double * ) const
  {
    itkExceptionMacro( << "Evaluate not implemented for spline order " << SplineOrder );
    return 0.0;
  }
 
 
};
 
} // end namespace itk
 
#endif