crocoddyl  1.9.0
Contact RObot COntrol by Differential DYnamic programming Library (Crocoddyl)
ResidualModelControlTpl< _Scalar > Class Template Reference

Define a control residual. More...

#include <crocoddyl/core/residuals/control.hpp>

Public Types

typedef ResidualModelAbstractTpl< Scalar > Base
 
typedef DataCollectorAbstractTpl< Scalar > DataCollectorAbstract
 
typedef MathBaseTpl< Scalar > MathBase
 
typedef MathBase::MatrixXs MatrixXs
 
typedef ResidualDataAbstractTpl< Scalar > ResidualDataAbstract
 
typedef MathBase::VectorXs VectorXs
 

Public Member Functions

 ResidualModelControlTpl (boost::shared_ptr< typename Base::StateAbstract > state)
 Initialize the control residual model. More...
 
 ResidualModelControlTpl (boost::shared_ptr< typename Base::StateAbstract > state, const std::size_t nu)
 Initialize the control residual model. More...
 
 ResidualModelControlTpl (boost::shared_ptr< typename Base::StateAbstract > state, const VectorXs &uref)
 Initialize the control residual model. More...
 
virtual void calc (const boost::shared_ptr< ResidualDataAbstract > &data, const Eigen::Ref< const VectorXs > &x)
 
virtual void calc (const boost::shared_ptr< ResidualDataAbstract > &data, const Eigen::Ref< const VectorXs > &x, const Eigen::Ref< const VectorXs > &u)
 Compute the control residual. More...
 
virtual void calcDiff (const boost::shared_ptr< ResidualDataAbstract > &data, const Eigen::Ref< const VectorXs > &x, const Eigen::Ref< const VectorXs > &u)
 Compute the derivatives of the control residual. More...
 
virtual boost::shared_ptr< ResidualDataAbstractcreateData (DataCollectorAbstract *const data)
 Create the control residual data.
 
const VectorXs & get_reference () const
 Return the reference control vector.
 
virtual void print (std::ostream &os) const
 Print relevant information of the control residual. More...
 
void set_reference (const VectorXs &reference)
 Modify the reference control vector.
 

Public Attributes

EIGEN_MAKE_ALIGNED_OPERATOR_NEW typedef _Scalar Scalar
 

Protected Attributes

std::size_t nu_
 Control dimension.
 
boost::shared_ptr< StateAbstractstate_
 State description.
 
VectorXs unone_
 No control vector.
 

Detailed Description

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

Define a control residual.

This residual function is defined as \(\mathbf{r}=\mathbf{u}-\mathbf{u}^*\), where \(\mathbf{u},\mathbf{u}^*\in~\mathbb{R}^{nu}\) are the current and reference control inputs, respectively. Note that the dimension of the residual vector is obtained from nu.

Both residual and residual Jacobians 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()

Definition at line 184 of file fwd.hpp.

Constructor & Destructor Documentation

◆ ResidualModelControlTpl() [1/3]

ResidualModelControlTpl ( boost::shared_ptr< typename Base::StateAbstract state,
const VectorXs &  uref 
)

Initialize the control residual model.

The default nu value is obtained from StateAbstractTpl::get_nv().

Parameters
[in]stateState of the multibody system
[in]urefReference control input

◆ ResidualModelControlTpl() [2/3]

ResidualModelControlTpl ( boost::shared_ptr< typename Base::StateAbstract state,
const std::size_t  nu 
)

Initialize the control residual model.

The default nu value is obtained from StateAbstractTpl::get_nv().

Parameters
[in]stateState of the multibody system
[in]nuDimension of the control vector

◆ ResidualModelControlTpl() [3/3]

ResidualModelControlTpl ( boost::shared_ptr< typename Base::StateAbstract state)
explicit

Initialize the control residual model.

The default reference control is obtained from MathBaseTpl<>::VectorXs::Zero(nu).

Parameters
[in]stateState of the multibody system

Member Function Documentation

◆ calc() [1/2]

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

Compute the control residual.

Parameters
[in]dataControl residual data
[in]xState point \(\mathbf{x}\in\mathbb{R}^{ndx}\)
[in]uControl input \(\mathbf{u}\in\mathbb{R}^{nu}\)

◆ calc() [2/2]

virtual void calc ( const boost::shared_ptr< ResidualDataAbstract > &  data,
const Eigen::Ref< const VectorXs > &  x 
)
virtual

It updates the residual vector based on the state only. This function is used in the terminal nodes of an optimal control problem.

Parameters
[in]dataResidual data
[in]xState point \(\mathbf{x}\in\mathbb{R}^{ndx}\)

◆ calcDiff()

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

Compute the derivatives of the control residual.

Parameters
[in]dataControl residual data
[in]xState point \(\mathbf{x}\in\mathbb{R}^{ndx}\)
[in]uControl input \(\mathbf{u}\in\mathbb{R}^{nu}\)

◆ print()

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

Print relevant information of the control residual.

Parameters
[out]osOutput stream object

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