rtkIterativeFDKConeBeamReconstructionFilter.h

Go to the documentation of this file.

/*=========================================================================
 *
 *  Copyright RTK 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
 *
 *         https://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 rtkIterativeFDKConeBeamReconstructionFilter_h
#define rtkIterativeFDKConeBeamReconstructionFilter_h

#include <itkMultiplyImageFilter.h>
#include <itkSubtractImageFilter.h>
#include <itkThresholdImageFilter.h>
#include <itkDivideOrZeroOutImageFilter.h>

#include "rtkConstantImageSource.h"
#include "rtkParkerShortScanImageFilter.h"
#include "rtkDisplacedDetectorForOffsetFieldOfViewImageFilter.h"
#include "rtkIterativeConeBeamReconstructionFilter.h"
#include "rtkFDKConeBeamReconstructionFilter.h"
#include "rtkRayBoxIntersectionImageFilter.h"

namespace rtk
{

template <class TInputImage, class TOutputImage = TInputImage, class TFFTPrecision = double>
class ITK_TEMPLATE_EXPORT IterativeFDKConeBeamReconstructionFilter
  : public rtk::IterativeConeBeamReconstructionFilter<TInputImage, TOutputImage>
{
public:
  ITK_DISALLOW_COPY_AND_MOVE(IterativeFDKConeBeamReconstructionFilter);

  using Self = IterativeFDKConeBeamReconstructionFilter;
  using Superclass = IterativeConeBeamReconstructionFilter<TInputImage, TOutputImage>;
  using Pointer = itk::SmartPointer<Self>;
  using ConstPointer = itk::SmartPointer<const Self>;

  using InputImageType = TInputImage;
  using OutputImageType = TOutputImage;

  using ForwardProjectionType = typename Superclass::ForwardProjectionType;
  using BackProjectionType = typename Superclass::BackProjectionType;

  using DisplacedDetectorFilterType = rtk::DisplacedDetectorImageFilter<OutputImageType, OutputImageType>;
  using ParkerFilterType = rtk::ParkerShortScanImageFilter<OutputImageType, OutputImageType>;
  using FDKFilterType = rtk::FDKConeBeamReconstructionFilter<OutputImageType, OutputImageType, TFFTPrecision>;
  using MultiplyFilterType = itk::MultiplyImageFilter<OutputImageType, OutputImageType, OutputImageType>;
  using SubtractFilterType = itk::SubtractImageFilter<OutputImageType, OutputImageType>;
  using ConstantImageSourceType = rtk::ConstantImageSource<OutputImageType>;
  using ThresholdFilterType = itk::ThresholdImageFilter<OutputImageType>;
  using DivideFilterType = itk::DivideOrZeroOutImageFilter<OutputImageType>;
  using RayBoxIntersectionFilterType = rtk::RayBoxIntersectionImageFilter<OutputImageType, OutputImageType>;

  itkNewMacro(Self);

  itkOverrideGetNameOfClassMacro(IterativeFDKConeBeamReconstructionFilter);

  itkGetModifiableObjectMacro(Geometry, ThreeDCircularProjectionGeometry);
  itkSetObjectMacro(Geometry, ThreeDCircularProjectionGeometry);

  itkGetMacro(NumberOfIterations, unsigned int);
  itkSetMacro(NumberOfIterations, unsigned int);

  itkGetMacro(Lambda, double);
  itkSetMacro(Lambda, double);

  itkGetMacro(EnforcePositivity, bool);
  itkSetMacro(EnforcePositivity, bool);

  void
  SetBackProjectionFilter(BackProjectionType itkNotUsed(_arg)) override
  {
    itkExceptionMacro(<< "Backprojection cannot be changed");
  }

  itkGetMacro(TruncationCorrection, double);
  itkSetMacro(TruncationCorrection, double);

  itkGetMacro(HannCutFrequency, double);
  itkSetMacro(HannCutFrequency, double);

  itkGetMacro(HannCutFrequencyY, double);
  itkSetMacro(HannCutFrequencyY, double);

  itkGetMacro(ProjectionSubsetSize, unsigned int);
  itkSetMacro(ProjectionSubsetSize, unsigned int);

  itkSetMacro(DisableDisplacedDetectorFilter, bool);
  itkGetMacro(DisableDisplacedDetectorFilter, bool);

protected:
  IterativeFDKConeBeamReconstructionFilter();
  ~IterativeFDKConeBeamReconstructionFilter() override = default;

  void
  VerifyPreconditions() const override;

  void
  GenerateInputRequestedRegion() override;

  void
  GenerateOutputInformation() override;

  void
  GenerateData() override;

  void
  VerifyInputInformation() const override
  {}

  typename Superclass::ForwardProjectionPointerType m_ForwardProjectionFilter;
  typename DisplacedDetectorFilterType::Pointer     m_DisplacedDetectorFilter;
  typename ParkerFilterType::Pointer                m_ParkerFilter;
  typename FDKFilterType::Pointer                   m_FDKFilter;
  typename ThresholdFilterType::Pointer             m_ThresholdFilter;
  typename SubtractFilterType::Pointer              m_SubtractFilter;
  typename MultiplyFilterType::Pointer              m_MultiplyFilter;
  typename ConstantImageSourceType::Pointer         m_ConstantProjectionStackSource;
  typename DivideFilterType::Pointer                m_DivideFilter;
  typename RayBoxIntersectionFilterType::Pointer    m_RayBoxFilter;

  bool   m_EnforcePositivity;
  double m_TruncationCorrection;
  double m_HannCutFrequency;
  double m_HannCutFrequencyY;
  double m_ProjectionSubsetSize;
  bool   m_DisableDisplacedDetectorFilter;

private:
  ThreeDCircularProjectionGeometry::Pointer m_Geometry;

  unsigned int m_NumberOfIterations;

  double m_Lambda;
}; // end of class

} // end namespace rtk

#ifndef ITK_MANUAL_INSTANTIATION
#  include "rtkIterativeFDKConeBeamReconstructionFilter.hxx"
#endif

#endif