itkGPUFiniteDifferenceImageFilter.h

Go to the documentation of this file.

/*=========================================================================
 *
 *  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 __itkGPUFiniteDifferenceImageFilter_h
#define __itkGPUFiniteDifferenceImageFilter_h

#include "itkGPUInPlaceImageFilter.h"
#include "itkGPUFiniteDifferenceFunction.h"
#include "itkFiniteDifferenceImageFilter.h"
#include "itkTimeProbe.h"

namespace itk
{
template< class TInputImage, class TOutputImage, class TParentImageFilter =
            FiniteDifferenceImageFilter< TInputImage, TOutputImage > >
class ITK_EXPORT GPUFiniteDifferenceImageFilter :
  public GPUInPlaceImageFilter< TInputImage, TOutputImage, TParentImageFilter >
{
public:

  typedef GPUFiniteDifferenceImageFilter                                         Self;
  typedef GPUInPlaceImageFilter< TInputImage, TOutputImage, TParentImageFilter > GPUSuperclass;
  typedef TParentImageFilter                                                     CPUSuperclass;
  typedef SmartPointer< Self >                                                   Pointer;
  typedef SmartPointer< const Self >                                             ConstPointer;

  itkTypeMacro(GPUFiniteDifferenceImageFilter, GPUInPlaceImageFilter);

  typedef TInputImage  InputImageType;
  typedef TOutputImage OutputImageType;

  itkStaticConstMacro(ImageDimension, unsigned int, OutputImageType::ImageDimension);

  typedef typename TOutputImage::PixelType OutputPixelType;
  typedef typename TInputImage::PixelType  InputPixelType;
  typedef OutputPixelType                  PixelType;

  typedef typename NumericTraits< OutputPixelType >::ValueType OutputPixelValueType;
  typedef typename NumericTraits< InputPixelType >::ValueType  InputPixelValueType;

  typedef typename GPUFiniteDifferenceFunction< TOutputImage >::DifferenceFunctionType FiniteDifferenceFunctionType;
  //typedef typename GPUFiniteDifferenceFunction< TOutputImage >
  // FiniteDifferenceFunctionType;
  typedef typename FiniteDifferenceFunctionType::TimeStepType           TimeStepType;
  typedef typename FiniteDifferenceFunctionType::RadiusType             RadiusType;
  typedef typename FiniteDifferenceFunctionType::NeighborhoodScalesType NeighborhoodScalesType;

  itkGetConstReferenceObjectMacro(DifferenceFunction, FiniteDifferenceFunctionType);
  //itkGetMacro(DifferenceFunction, FiniteDifferenceFunctionType);

  itkSetObjectMacro(DifferenceFunction, FiniteDifferenceFunctionType);

  typedef enum { UNINITIALIZED = 0, INITIALIZED = 1 } FilterStateType;

  itkSetMacro(UseImageSpacing, bool);
  itkBooleanMacro(UseImageSpacing);
  itkGetConstReferenceMacro(UseImageSpacing, bool);

  itkSetMacro(MaximumRMSError, double);
  itkGetConstReferenceMacro(MaximumRMSError, double);

  itkSetMacro(RMSChange, double);
  itkGetConstReferenceMacro(RMSChange, double);

  void SetStateToInitialized()
  {
    this->SetState(INITIALIZED);
  }

  void SetStateToUninitialized()
  {
    this->SetState(UNINITIALIZED);
  }

#if !defined( CABLE_CONFIGURATION )
  itkSetMacro(State, FilterStateType);
  itkGetConstReferenceMacro(State, FilterStateType);
#endif


  itkSetMacro(ManualReinitialization, bool);
  itkGetConstReferenceMacro(ManualReinitialization, bool);
  itkBooleanMacro(ManualReinitialization);

#ifdef ITK_USE_STRICT_CONCEPT_CHECKING

  itkConceptMacro( OutputPixelIsFloatingPointCheck,
                   ( Concept::IsFloatingPoint< OutputPixelValueType > ) );

#endif

  itkGetConstReferenceMacro(InitTime,           TimeProbe);
  itkGetConstReferenceMacro(ComputeUpdateTime,  TimeProbe);
  itkGetConstReferenceMacro(ApplyUpdateTime,    TimeProbe);
  itkGetConstReferenceMacro(SmoothFieldTime,    TimeProbe);

protected:
  GPUFiniteDifferenceImageFilter();
  ~GPUFiniteDifferenceImageFilter();

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

  virtual void AllocateUpdateBuffer() = 0;

  virtual void GPUApplyUpdate(const TimeStepType& dt) = 0;

  virtual TimeStepType GPUCalculateChange() = 0;

  virtual void CopyInputToOutput() = 0;

  virtual void GPUGenerateData();

  virtual void GenerateInputRequestedRegion();

  virtual bool Halt();

  virtual bool ThreadedHalt( void *itkNotUsed(threadInfo) ) {
    return this->Halt();
  }

  virtual void Initialize() {
  }

  virtual void InitializeIteration()
  {
    m_DifferenceFunction->InitializeIteration();
  }

virtual TimeStepType ResolveTimeStep(const std::vector<TimeStepType >& timeStepList,
                                     const std::vector< bool >& valid) const;

  virtual void PostProcessOutput() {
  }

  itkSetMacro(ElapsedIterations, IdentifierType);

  //unsigned int m_NumberOfIterations;

  //unsigned int m_ElapsedIterations;

  bool m_ManualReinitialization;

  double m_RMSChange;
  double m_MaximumRMSError;

  TimeProbe m_InitTime, m_ComputeUpdateTime, m_ApplyUpdateTime, m_SmoothFieldTime;

private:

  GPUFiniteDifferenceImageFilter(const Self &); //purposely not implemented
  void operator=(const Self &);                 //purposely not implemented

  void InitializeFunctionCoefficients();

  typename FiniteDifferenceFunctionType::Pointer m_DifferenceFunction;

  bool m_UseImageSpacing;

  FilterStateType m_State;
};
} // end namespace itk

#if ITK_TEMPLATE_TXX
#include "itkGPUFiniteDifferenceImageFilter.hxx"
#endif

#endif