frame-rotation.hpp

// BSD 3-Clause License
//
// Copyright (C) 2021-2025, LAAS-CNRS, University of Edinburgh,
//                          Heriot-Watt University
// Copyright note valid unless otherwise stated in individual files.
// All rights reserved.
 
#ifndef CROCODDYL_MULTIBODY_RESIDUALS_FRAME_ROTATION_HPP_
#define CROCODDYL_MULTIBODY_RESIDUALS_FRAME_ROTATION_HPP_
 
#include "crocoddyl/core/residual-base.hpp"
#include "crocoddyl/multibody/data/multibody.hpp"
#include "crocoddyl/multibody/fwd.hpp"
#include "crocoddyl/multibody/states/multibody.hpp"
 
namespace crocoddyl {
 
template <typename _Scalar>
class ResidualModelFrameRotationTpl : public ResidualModelAbstractTpl<_Scalar> {
 public:
  EIGEN_MAKE_ALIGNED_OPERATOR_NEW
  CROCODDYL_DERIVED_CAST(ResidualModelBase, ResidualModelFrameRotationTpl)
 
  typedef _Scalar Scalar;
  typedef MathBaseTpl<Scalar> MathBase;
  typedef ResidualModelAbstractTpl<Scalar> Base;
  typedef ResidualDataFrameRotationTpl<Scalar> Data;
  typedef StateMultibodyTpl<Scalar> StateMultibody;
  typedef ResidualDataAbstractTpl<Scalar> ResidualDataAbstract;
  typedef DataCollectorAbstractTpl<Scalar> DataCollectorAbstract;
  typedef typename MathBase::VectorXs VectorXs;
  typedef typename MathBase::Matrix3s Matrix3s;
 
  ResidualModelFrameRotationTpl(std::shared_ptr<StateMultibody> state,
                                const pinocchio::FrameIndex id,
                                const Matrix3s& Rref, const std::size_t nu);
 
  ResidualModelFrameRotationTpl(std::shared_ptr<StateMultibody> state,
                                const pinocchio::FrameIndex id,
                                const Matrix3s& Rref);
  virtual ~ResidualModelFrameRotationTpl() = default;
 
  virtual void calc(const std::shared_ptr<ResidualDataAbstract>& data,
                    const Eigen::Ref<const VectorXs>& x,
                    const Eigen::Ref<const VectorXs>& u) override;
 
  virtual void calcDiff(const std::shared_ptr<ResidualDataAbstract>& data,
                        const Eigen::Ref<const VectorXs>& x,
                        const Eigen::Ref<const VectorXs>& u) override;
 
  virtual std::shared_ptr<ResidualDataAbstract> createData(
      DataCollectorAbstract* const data) override;
 
  template <typename NewScalar>
  ResidualModelFrameRotationTpl<NewScalar> cast() const;
 
  pinocchio::FrameIndex get_id() const;
 
  const Matrix3s& get_reference() const;
 
  void set_id(const pinocchio::FrameIndex id);
 
  void set_reference(const Matrix3s& reference);
 
  virtual void print(std::ostream& os) const override;
 
 protected:
  using Base::nu_;
  using Base::state_;
  using Base::u_dependent_;
  using Base::v_dependent_;
 
 private:
  pinocchio::FrameIndex id_;  
  Matrix3s Rref_;             
  Matrix3s oRf_inv_;          
  std::shared_ptr<typename StateMultibody::PinocchioModel>
      pin_model_;  
};
 
template <typename _Scalar>
struct ResidualDataFrameRotationTpl : public ResidualDataAbstractTpl<_Scalar> {
  EIGEN_MAKE_ALIGNED_OPERATOR_NEW
 
  typedef _Scalar Scalar;
  typedef MathBaseTpl<Scalar> MathBase;
  typedef ResidualDataAbstractTpl<Scalar> Base;
  typedef DataCollectorAbstractTpl<Scalar> DataCollectorAbstract;
  typedef typename MathBase::Vector3s Vector3s;
  typedef typename MathBase::Matrix3s Matrix3s;
  typedef typename MathBase::Matrix3xs Matrix3xs;
  typedef typename MathBase::Matrix6xs Matrix6xs;
 
  template <template <typename Scalar> class Model>
  ResidualDataFrameRotationTpl(Model<Scalar>* const model,
                               DataCollectorAbstract* const data)
      : Base(model, data), rJf(3, 3), fJf(6, model->get_state()->get_nv()) {
    r.setZero();
    rRf.setIdentity();
    rJf.setZero();
    fJf.setZero();
    // Check that proper shared data has been passed
    DataCollectorMultibodyTpl<Scalar>* d =
        dynamic_cast<DataCollectorMultibodyTpl<Scalar>*>(shared);
    if (d == NULL) {
      throw_pretty(
          "Invalid argument: the shared data should be derived from "
          "DataCollectorMultibody");
    }
 
    // Avoids data casting at runtime
    pinocchio = d->pinocchio;
  }
  virtual ~ResidualDataFrameRotationTpl() = default;
 
  pinocchio::DataTpl<Scalar>* pinocchio;  
  Matrix3s rRf;                           
  Matrix3s rJf;                           
  Matrix6xs fJf;                          
 
  using Base::r;
  using Base::Ru;
  using Base::Rx;
  using Base::shared;
};
 
}  // namespace crocoddyl
 
/* --- Details -------------------------------------------------------------- */
/* --- Details -------------------------------------------------------------- */
/* --- Details -------------------------------------------------------------- */
#include "crocoddyl/multibody/residuals/frame-rotation.hxx"
 
CROCODDYL_DECLARE_EXTERN_TEMPLATE_CLASS(
    crocoddyl::ResidualModelFrameRotationTpl)
CROCODDYL_DECLARE_EXTERN_TEMPLATE_STRUCT(
    crocoddyl::ResidualDataFrameRotationTpl)
 
#endif  // CROCODDYL_MULTIBODY_RESIDUALS_FRAME_ROTATION_HPP_