Abstract class for the actuation-mapping model. More...

#include <actuation-base.hpp>

Inheritance diagram for ActuationModelAbstractTpl< _Scalar >:

Public Types
typedef ActuationDataAbstractTpl< Scalar >	ActuationDataAbstract

typedef MathBaseTpl< Scalar >	MathBase

typedef MathBase::MatrixXs	MatrixXs

typedef StateAbstractTpl< Scalar >	StateAbstract

typedef MathBase::VectorXs	VectorXs

Public Member Functions
	ActuationModelAbstractTpl (std::shared_ptr< StateAbstract > state, const std::size_t nu)
	Initialize the actuation model.

void	calc (const std::shared_ptr< ActuationDataAbstract > &data, const Eigen::Ref< const VectorXs > &x)
	Ignore the computation of the actuation signal.

virtual void	calc (const std::shared_ptr< ActuationDataAbstract > &data, const Eigen::Ref< const VectorXs > &x, const Eigen::Ref< const VectorXs > &u)=0
	Compute the actuation signal from the state point \(\mathbf{x}\in\mathbb{R}^{ndx}\) and joint torque inputs \(\mathbf{u}\in\mathbb{R}^{nu}\).

void	calcDiff (const std::shared_ptr< ActuationDataAbstract > &data, const Eigen::Ref< const VectorXs > &x)
	Ignore the computation of the Jacobians of the actuation function.

virtual void	calcDiff (const std::shared_ptr< ActuationDataAbstract > &data, const Eigen::Ref< const VectorXs > &x, const Eigen::Ref< const VectorXs > &u)=0
	Compute the Jacobians of the actuation function.

virtual void	commands (const std::shared_ptr< ActuationDataAbstract > &data, const Eigen::Ref< const VectorXs > &x, const Eigen::Ref< const VectorXs > &tau)=0
	Compute the joint torque input from the generalized torques.

virtual std::shared_ptr< ActuationDataAbstract >	createData ()
	Create the actuation data.

std::size_t	get_nu () const
	Return the dimension of the joint-torque input.

const std::shared_ptr< StateAbstract > &	get_state () const
	Return the state.

virtual void	print (std::ostream &os) const
	Print relevant information of the residual model.

virtual void	torqueTransform (const std::shared_ptr< ActuationDataAbstract > &data, const Eigen::Ref< const VectorXs > &x, const Eigen::Ref< const VectorXs > &u)
	Compute the torque transform from generalized torques to joint torque inputs.

Public Attributes
EIGEN_MAKE_ALIGNED_OPERATOR_NEW typedef _Scalar	Scalar

Protected Attributes
std::size_t	nu_
	Dimension of joint torque inputs.

std::shared_ptr< StateAbstract >	state_
	Model of the state.

Friends
template<class Scalar >
std::ostream &	operator<< (std::ostream &os, const ResidualModelAbstractTpl< Scalar > &model)
	Print information on the residual model.

Detailed Description

template<typename _Scalar>
class crocoddyl::ActuationModelAbstractTpl< _Scalar >

Abstract class for the actuation-mapping model.

The generalized torques \(\boldsymbol{\tau}\in\mathbb{R}^{nv}\) can by any nonlinear function of the joint-torque inputs \(\mathbf{u}\in\mathbb{R}^{nu}\), and state point \(\mathbf{x}\in\mathbb{R}^{nx}\), where nv, nu, and ndx are the number of joints, dimension of the joint torque input and state manifold, respectively. Additionally, the generalized torques are also named as the actuation signals of our system.

The main computations are carried out in calc(), and calcDiff(), where the former computes actuation signal, and the latter computes the Jacobians of the actuation-mapping function, i.e., \(\frac{\partial\boldsymbol{\tau}}{\partial\mathbf{x}}\) and \(\frac{\partial\boldsymbol{\tau}}{\partial\mathbf{u}}\). Note that calcDiff() requires to run calc() first.

See also: calc(), calcDiff(), createData()

Definition at line 45 of file actuation-base.hpp.

Member Typedef Documentation

◆ MathBase

template<typename _Scalar >

typedef MathBaseTpl<Scalar> MathBase

Definition at line 50 of file actuation-base.hpp.

◆ StateAbstract

template<typename _Scalar >

typedef StateAbstractTpl<Scalar> StateAbstract

Definition at line 51 of file actuation-base.hpp.

◆ ActuationDataAbstract

template<typename _Scalar >

typedef ActuationDataAbstractTpl<Scalar> ActuationDataAbstract

Definition at line 52 of file actuation-base.hpp.

◆ VectorXs

template<typename _Scalar >

typedef MathBase::VectorXs VectorXs

Definition at line 53 of file actuation-base.hpp.

◆ MatrixXs

template<typename _Scalar >

typedef MathBase::MatrixXs MatrixXs

Definition at line 54 of file actuation-base.hpp.

Constructor & Destructor Documentation

◆ ActuationModelAbstractTpl()

template<typename _Scalar >

ActuationModelAbstractTpl	(	std::shared_ptr< StateAbstract >	state,
		const std::size_t	nu
	)

Initialize the actuation model.

Parameters

[in]	state	State description
[in]	nu	Dimension of joint-torque input

Member Function Documentation

◆ calc() [1/2]

template<typename _Scalar >

virtual void calc	(	const std::shared_ptr< ActuationDataAbstract > &	data,
		const Eigen::Ref< const VectorXs > &	x,
		const Eigen::Ref< const VectorXs > &	u
	)

pure virtual

Compute the actuation signal from the state point \(\mathbf{x}\in\mathbb{R}^{ndx}\) and joint torque inputs \(\mathbf{u}\in\mathbb{R}^{nu}\).

Parameters

[in]	data	Actuation data
[in]	x	State point \(\mathbf{x}\in\mathbb{R}^{ndx}\)
[in]	u	Joint-torque input \(\mathbf{u}\in\mathbb{R}^{nu}\)

Implemented in ActuationSquashingModelTpl< _Scalar >, ActuationModelNumDiffTpl< _Scalar >, ActuationModelFloatingBaseThrustersTpl< _Scalar >, ActuationModelFloatingBaseTpl< _Scalar >, ActuationModelFullTpl< _Scalar >, and ActuationModelMultiCopterBaseTpl< _Scalar >.

◆ calc() [2/2]

template<typename _Scalar >

void calc	(	const std::shared_ptr< ActuationDataAbstract > &	data,
		const Eigen::Ref< const VectorXs > &	x
	)

Ignore the computation of the actuation signal.

It does not update the actuation signal as this function is used in the terminal nodes of an optimal control problem.

Parameters

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

◆ calcDiff() [1/2]

template<typename _Scalar >

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

pure virtual

Compute the Jacobians of the actuation function.

Parameters

[in]	data	Actuation data
[in]	x	State point \(\mathbf{x}\in\mathbb{R}^{ndx}\)
[in]	u	Joint-torque input \(\mathbf{u}\in\mathbb{R}^{nu}\)

Implemented in ActuationSquashingModelTpl< _Scalar >, ActuationModelNumDiffTpl< _Scalar >, ActuationModelFloatingBaseThrustersTpl< _Scalar >, ActuationModelFloatingBaseTpl< _Scalar >, ActuationModelFullTpl< _Scalar >, and ActuationModelMultiCopterBaseTpl< _Scalar >.

◆ calcDiff() [2/2]

template<typename _Scalar >

void calcDiff	(	const std::shared_ptr< ActuationDataAbstract > &	data,
		const Eigen::Ref< const VectorXs > &	x
	)

Ignore the computation of the Jacobians of the actuation function.

It does not update the Jacobians of the actuation function as this function is used in the terminal nodes of an optimal control problem.

Parameters

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

◆ commands()

template<typename _Scalar >

virtual void commands	(	const std::shared_ptr< ActuationDataAbstract > &	data,
		const Eigen::Ref< const VectorXs > &	x,
		const Eigen::Ref< const VectorXs > &	tau
	)

pure virtual

Compute the joint torque input from the generalized torques.

It stores the results in ActuationDataAbstractTpl::u.

Parameters

[in]	data	Actuation data
[in]	x	State point \(\mathbf{x}\in\mathbb{R}^{ndx}\)
[in]	tau	Generalized torques \(\mathbf{u}\in\mathbb{R}^{nv}\)

Implemented in ActuationSquashingModelTpl< _Scalar >, ActuationModelNumDiffTpl< _Scalar >, ActuationModelFloatingBaseThrustersTpl< _Scalar >, ActuationModelFloatingBaseTpl< _Scalar >, ActuationModelFullTpl< _Scalar >, and ActuationModelMultiCopterBaseTpl< _Scalar >.

◆ torqueTransform()

template<typename _Scalar >

virtual void torqueTransform	(	const std::shared_ptr< ActuationDataAbstract > &	data,
		const Eigen::Ref< const VectorXs > &	x,
		const Eigen::Ref< const VectorXs > &	u
	)

virtual

Compute the torque transform from generalized torques to joint torque inputs.

It stores the results in ActuationDataAbstractTpl::Mtau.

Parameters

[in]	data	Actuation data
[in]	x	State point \(\mathbf{x}\in\mathbb{R}^{ndx}\)
[in]	tau	Joint-torque inputs \(\mathbf{u}\in\mathbb{R}^{nu}\)

Reimplemented in ActuationModelNumDiffTpl< _Scalar >, ActuationModelFloatingBaseThrustersTpl< _Scalar >, ActuationModelFloatingBaseTpl< _Scalar >, ActuationModelFullTpl< _Scalar >, and ActuationModelMultiCopterBaseTpl< _Scalar >.

◆ createData()

template<typename _Scalar >

virtual std::shared_ptr< ActuationDataAbstract > createData ( )

virtual

Create the actuation data.

Returns: the actuation data

Reimplemented in ActuationSquashingModelTpl< _Scalar >, ActuationModelNumDiffTpl< _Scalar >, ActuationModelFloatingBaseThrustersTpl< _Scalar >, ActuationModelFloatingBaseTpl< _Scalar >, ActuationModelFullTpl< _Scalar >, and ActuationModelMultiCopterBaseTpl< _Scalar >.

◆ print()

template<typename _Scalar >

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

virtual

Print relevant information of the residual model.

Parameters

[out] os Output stream object

Reimplemented in ActuationModelFloatingBaseThrustersTpl< _Scalar >.

Member Data Documentation

◆ Scalar

template<typename _Scalar >

EIGEN_MAKE_ALIGNED_OPERATOR_NEW typedef _Scalar Scalar

Definition at line 49 of file actuation-base.hpp.

◆ nu_

template<typename _Scalar >

std::size_t nu_

protected

Dimension of joint torque inputs.

Definition at line 172 of file actuation-base.hpp.

◆ state_

template<typename _Scalar >

std::shared_ptr<StateAbstract> state_

protected

Model of the state.

Definition at line 173 of file actuation-base.hpp.

The documentation for this class was generated from the following file:

/root/robotpkg/optimization/py-crocoddyl/work/crocoddyl-2.1.0/include/crocoddyl/core/actuation-base.hpp

Public Types

Public Member Functions

Public Attributes

Protected Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ MathBase

◆ StateAbstract

◆ ActuationDataAbstract

◆ VectorXs

◆ MatrixXs

Constructor & Destructor Documentation

◆ ActuationModelAbstractTpl()

Member Function Documentation

◆ calc() [1/2]

◆ calc() [2/2]

◆ calcDiff() [1/2]

◆ calcDiff() [2/2]

◆ commands()

◆ torqueTransform()

◆ createData()

◆ print()

Member Data Documentation

◆ Scalar

◆ nu_

◆ state_