Template Class ResidualModelFrameRotationTpl

Inheritance Relationships

Base Type

Class Documentation

template<typename _Scalar>
class ResidualModelFrameRotationTpl : public crocoddyl::ResidualModelAbstractTpl<_Scalar>

Frame rotation residual.

This residual function is defined as \(\mathbf{r}=\mathbf{R}\ominus\mathbf{R}^*\), where \(\mathbf{R},\mathbf{R}^*\in~\mathbb{SO(3)}\) are the current and reference frame rotations, respectively. Note that the dimension of the residual vector is 3. Furthermore, the Jacobians of the residual function are computed analytically.

As described in ResidualModelAbstractTpl(), the residual value and its Jacobians are calculated by calc and calcDiff, respectively.

See also

ResidualModelAbstractTpl, calc(), calcDiff(), createData()

Public Types

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 MathBase::VectorXs VectorXs
typedef MathBase::Matrix3s Matrix3s

Public Functions

ResidualModelFrameRotationTpl(std::shared_ptr<StateMultibody> state, const pinocchio::FrameIndex id, const Matrix3s &Rref, const std::size_t nu)

Initialize the frame rotation residual model.

Parameters:

  • state – [in] State of the multibody system

  • id – [in] Reference frame id

  • Rref – [in] Reference frame rotation

  • nu – [in] Dimension of the control vector

ResidualModelFrameRotationTpl(std::shared_ptr<StateMultibody> state, const pinocchio::FrameIndex id, const Matrix3s &Rref)

Initialize the frame rotation residual model.

The default nu is equals to StateAbstractTpl::get_nv().

Parameters:

  • state – [in] State of the multibody system

  • id – [in] Reference frame id

  • Rref – [in] Reference frame rotation

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

Compute the frame rotation residual.

Parameters:

  • data – [in] Frame rotation residual data

  • x – [in] State point \(\mathbf{x}\in\mathbb{R}^{ndx}\)

  • u – [in] Control input \(\mathbf{u}\in\mathbb{R}^{nu}\)

virtual void calcDiff(const std::shared_ptr<ResidualDataAbstract> &data, const Eigen::Ref<const VectorXs> &x, const Eigen::Ref<const VectorXs> &u) override

Compute the derivatives of the frame rotation residual.

Parameters:

  • data – [in] Frame rotation residual data

  • x – [in] State point \(\mathbf{x}\in\mathbb{R}^{ndx}\)

  • u – [in] Control input \(\mathbf{u}\in\mathbb{R}^{nu}\)

virtual std::shared_ptr<ResidualDataAbstract> createData(DataCollectorAbstract *const data) override

Create the frame rotation residual data.

template<typename NewScalar>
ResidualModelFrameRotationTpl<NewScalar> cast() const

Cast the frame-rotation residual model to a different scalar type.

It is useful for operations requiring different precision or scalar types.

Template Parameters:

NewScalar – The new scalar type to cast to.

Returns:

ResidualModelFrameRotationTpl<NewScalar> A residual model with the new scalar type.

pinocchio::FrameIndex get_id() const

Return the reference frame id.

const Matrix3s &get_reference() const

Return the reference frame rotation.

void set_id(const pinocchio::FrameIndex id)

Modify the reference frame id.

void set_reference(const Matrix3s &reference)

Modify the reference frame rotation.

virtual void print(std::ostream &os) const override

Print relevant information of the frame-rotation residual.

Parameters:

os – [out] Output stream object

Public Members

EIGEN_MAKE_ALIGNED_OPERATOR_NEW typedef _Scalar Scalar

Protected Attributes

std::size_t nu_

Control dimension.

std::shared_ptr<StateAbstract> state_

State description.

bool u_dependent_

Label that indicates if the residual function depends on u

bool v_dependent_

Label that indicates if the residual function depends on v