otbRationalTransform.h

Go to the documentation of this file.

/*
 * Copyright (C) 2005-2022 Centre National d'Etudes Spatiales (CNES)
 *
 * This file is part of Orfeo Toolbox
 *
 *     https://www.orfeo-toolbox.org/
 *
 * 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
 *
 * 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 otbRationalTransform_h
#define otbRationalTransform_h
 
#include "otbTransform.h"
#include "itkMacro.h"
 
namespace otb
{
template <class TScalarType = double, unsigned int Dimension = 2>
class ITK_EXPORT RationalTransform : public Transform<TScalarType, Dimension, Dimension>
{
public:
  typedef Transform<TScalarType, Dimension, Dimension> Superclass;
  typedef RationalTransform             Self;
  typedef itk::SmartPointer<Self>       Pointer;
  typedef itk::SmartPointer<const Self> ConstPointer;
 
  typedef typename Superclass::ScalarType ScalarType;
  typedef itk::Point<ScalarType, Dimension> InputPointType;
  typedef itk::Point<ScalarType, Dimension> OutputPointType;
 
  typedef itk::Vector<double, Dimension> SpacingType;
  typedef itk::Point<double, Dimension>  OriginType;
 
  typedef typename Superclass::InverseTransformBasePointer InverseTransformBasePointer;
  typedef typename Superclass::ParametersType              ParametersType;
 
  typedef typename Superclass::ParametersValueType    ParametersValueType;
  typedef typename Superclass::NumberOfParametersType NumberOfParametersType;
 
  itkNewMacro(Self);
 
  itkTypeMacro(RationalTransform, Transform);
 
  itkStaticConstMacro(SpaceDimension, unsigned int, Dimension);
 
  void SetNumeratorDegree(unsigned int value)
  {
    this->m_NumeratorDegree = value;
    this->InitializeParameters();
  }
 
  itkGetConstMacro(NumeratorDegree, unsigned int);
 
  void SetDenominatorDegree(unsigned int value)
  {
    this->m_DenominatorDegree = value;
    this->InitializeParameters();
  }
 
  itkGetConstMacro(DenominatorDegree, unsigned int);
 
  OutputPointType TransformPoint(const InputPointType& point) const override
  {
    // Check for consistency
    if (this->GetNumberOfParameters() != this->m_Parameters.size())
    {
      {
        itkExceptionMacro(<< "Wrong number of parameters: found " << this->m_Parameters.Size() << ", expected " << this->GetNumberOfParameters());
      }
    }
 
    InputPointType  inputPoint = point;
    OutputPointType outputPoint;
 
    unsigned int dimensionStride = (m_DenominatorDegree + 1) + (m_NumeratorDegree + 1);
 
    // Compute RPC transform
    for (unsigned int dim = 0; dim < SpaceDimension; ++dim)
    {
      // 1) Initialize numerator and denominator
      TScalarType num          = itk::NumericTraits<TScalarType>::Zero;
      TScalarType denom        = itk::NumericTraits<TScalarType>::Zero;
      TScalarType currentPower = 1.;
 
      // 2) Compute numerator
      for (unsigned int numDegree = 0; numDegree <= m_NumeratorDegree; ++numDegree)
      {
        num += this->m_Parameters[dim * dimensionStride + numDegree] * currentPower;
        currentPower *= inputPoint[dim];
      }
 
      // 3) Compute denominator
      currentPower = 1.;
      for (unsigned int denomDegree = 0; denomDegree <= m_DenominatorDegree; ++denomDegree)
      {
        denom += this->m_Parameters[dim * dimensionStride + m_NumeratorDegree + denomDegree + 1] * currentPower;
        currentPower *= inputPoint[dim];
      }
 
      // 4) Fill the output
      outputPoint[dim] = num / denom;
    }
 
    // Return the output point
    return outputPoint;
  }
 
  NumberOfParametersType GetNumberOfParameters() const override
  {
    return (static_cast<NumberOfParametersType>((m_NumeratorDegree + 1 + m_DenominatorDegree + 1) * SpaceDimension));
  }
 
  // Set parameter method
  void SetParameters(const typename Superclass::ParametersType& params) override
  {
    // Check for the appropriate size
    if (params.Size() != this->GetNumberOfParameters())
    {
      itkExceptionMacro(<< "Wrong number of parameters: found " << params.Size() << ", expected " << this->GetNumberOfParameters());
    }
 
    // Set parametersg
    this->m_Parameters = params;
  }
 
  void InitializeParameters()
  {
    this->m_Parameters.SetSize(this->GetNumberOfParameters());
    this->m_Parameters.Fill(0);
    unsigned int dimensionStride = (m_DenominatorDegree + 1) + (m_NumeratorDegree + 1);
 
    for (unsigned int dim = 0; dim < SpaceDimension; ++dim)
    {
      this->m_Parameters[dimensionStride * dim + m_NumeratorDegree + 1] = 1.;
    }
  }
 
 
protected:
  RationalTransform() : Superclass(16), m_NumeratorDegree(3), m_DenominatorDegree(3)
  {
    this->InitializeParameters();
  }
 
 
  ~RationalTransform() override
  {
  }
 
  void PrintSelf(std::ostream& os, itk::Indent indent) const override
  {
    Superclass::PrintSelf(os, indent);
    os << indent << "Numerator Degree : " << m_NumeratorDegree << std::endl;
    os << indent << "Denominator Degree : " << m_DenominatorDegree << std::endl;
  }
 
private:
  RationalTransform(const Self&) = delete;
  void operator=(const Self&) = delete;
 
  // Degree of numerator
  unsigned int m_NumeratorDegree;
 
  // Degree of denominator
  unsigned int m_DenominatorDegree;
};
 
} // namespace otb
 
#endif