rtkUnwarpSequenceImageFilter.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 rtkUnwarpSequenceImageFilter_h
#define rtkUnwarpSequenceImageFilter_h

#include "rtkConjugateGradientImageFilter.h"
#include "rtkUnwarpSequenceConjugateGradientOperator.h"
#include "rtkWarpSequenceImageFilter.h"
#include "rtkConstantImageSource.h"

#ifdef RTK_USE_CUDA
#  include "rtkCudaConjugateGradientImageFilter.h"
#  include "rtkCudaConstantVolumeSeriesSource.h"
#endif

namespace rtk
{
template <typename TImageSequence,
          typename TDVFImageSequence =
            itk::Image<itk::CovariantVector<typename TImageSequence::ValueType, TImageSequence::ImageDimension - 1>,
                       TImageSequence::ImageDimension>,
          typename TImage = itk::Image<typename TImageSequence::ValueType, TImageSequence::ImageDimension - 1>,
          typename TDVFImage =
            itk::Image<itk::CovariantVector<typename TImageSequence::ValueType, TImageSequence::ImageDimension - 1>,
                       TImageSequence::ImageDimension - 1>>
class ITK_TEMPLATE_EXPORT UnwarpSequenceImageFilter : public itk::ImageToImageFilter<TImageSequence, TImageSequence>
{
public:
  ITK_DISALLOW_COPY_AND_MOVE(UnwarpSequenceImageFilter);

  using Self = UnwarpSequenceImageFilter;
  using Superclass = itk::ImageToImageFilter<TImageSequence, TImageSequence>;
  using Pointer = itk::SmartPointer<Self>;

  itkNewMacro(Self);

  itkOverrideGetNameOfClassMacro(UnwarpSequenceImageFilter);

  using CGOperatorFilterType =
    UnwarpSequenceConjugateGradientOperator<TImageSequence, TDVFImageSequence, TImage, TDVFImage>;
  using WarpForwardFilterType = WarpSequenceImageFilter<TImageSequence, TDVFImageSequence, TImage, TDVFImage>;
  using ConjugateGradientFilterType = ConjugateGradientImageFilter<TImageSequence>;

  using CPUImageSequence = typename itk::Image<typename TImageSequence::PixelType, TImageSequence::ImageDimension>;
#ifdef RTK_USE_CUDA
  using ConstantSourceType = typename std::conditional_t<std::is_same_v<TImageSequence, CPUImageSequence>,
                                                         ConstantImageSource<TImageSequence>,
                                                         CudaConstantVolumeSeriesSource>;
  using CudaConjugateGradientType = typename std::conditional_t<std::is_same_v<TImageSequence, CPUImageSequence>,
                                                                ConjugateGradientFilterType,
                                                                CudaConjugateGradientImageFilter<TImageSequence>>;
#else
  using ConstantSourceType = ConstantImageSource<TImageSequence>;
  using CudaConjugateGradientType = ConjugateGradientFilterType;
#endif

  void
  SetDisplacementField(const TDVFImageSequence * DVFs);

  typename TDVFImageSequence::Pointer
  GetDisplacementField();

  itkSetMacro(NumberOfIterations, float);
  itkGetMacro(NumberOfIterations, float);

  itkSetMacro(PhaseShift, float);
  itkGetMacro(PhaseShift, float);

  itkSetMacro(UseNearestNeighborInterpolationInWarping, bool);
  itkGetMacro(UseNearestNeighborInterpolationInWarping, bool);

  itkSetMacro(CudaConjugateGradient, bool);
  itkGetMacro(CudaConjugateGradient, bool);

  itkSetMacro(UseCudaCyclicDeformation, bool);
  itkGetMacro(UseCudaCyclicDeformation, bool);

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

  void
  GenerateData() override;

  typename ConjugateGradientFilterType::Pointer m_ConjugateGradientFilter;
  typename CGOperatorFilterType::Pointer        m_CGOperator;
  typename WarpForwardFilterType::Pointer       m_WarpForwardFilter;
  typename ConstantSourceType::Pointer          m_ConstantSource;

  float m_PhaseShift;

  void
  VerifyInputInformation() const override
  {}

  void
  GenerateInputRequestedRegion() override;
  void
  GenerateOutputInformation() override;

  bool m_UseNearestNeighborInterpolationInWarping; // Default is false, linear interpolation is used instead
  bool m_CudaConjugateGradient;
  bool m_UseCudaCyclicDeformation;

private:
  unsigned int m_NumberOfIterations;
};
} // namespace rtk


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

#endif