frame-rotation.hpp

// BSD 3-Clause License
//
// Copyright (C) 2021-2026, 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/core/utils/conversions.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_