joint_limits Namespace Reference

Classes
class	JointLimiterInterface
struct	JointLimits
struct	SoftJointLimits
class	JointSaturationLimiter

Typedefs
using	JointLimitsStateDataType = trajectory_msgs::msg::JointTrajectoryPoint

Functions
bool	declare_parameters (const std::string &joint_name, const rclcpp::node_interfaces::NodeParametersInterface::SharedPtr &param_itf, const rclcpp::node_interfaces::NodeLoggingInterface::SharedPtr &logging_itf)
bool	declare_parameters (const std::string &joint_name, const rclcpp::Node::SharedPtr &node)
bool	declare_parameters (const std::string &joint_name, const rclcpp_lifecycle::LifecycleNode::SharedPtr &lifecycle_node)
bool	get_joint_limits (const std::string &joint_name, const rclcpp::node_interfaces::NodeParametersInterface::SharedPtr &param_itf, const rclcpp::node_interfaces::NodeLoggingInterface::SharedPtr &logging_itf, JointLimits &limits)
	Populate a JointLimits instance from the node parameters. More...
bool	get_joint_limits (const std::string &joint_name, const rclcpp::Node::SharedPtr &node, JointLimits &limits)
bool	get_joint_limits (const std::string &joint_name, const rclcpp_lifecycle::LifecycleNode::SharedPtr &lifecycle_node, JointLimits &limits)
bool	check_for_limits_update (const std::string &joint_name, const std::vector< rclcpp::Parameter > &parameters, const rclcpp::node_interfaces::NodeLoggingInterface::SharedPtr &logging_itf, JointLimits &updated_limits)
bool	get_joint_limits (const std::string &joint_name, const rclcpp::node_interfaces::NodeParametersInterface::SharedPtr &param_itf, const rclcpp::node_interfaces::NodeLoggingInterface::SharedPtr &logging_itf, SoftJointLimits &soft_limits)
	Populate a SoftJointLimits instance from the ROS parameter server. More...
bool	get_joint_limits (const std::string &joint_name, const rclcpp::Node::SharedPtr &node, SoftJointLimits &soft_limits)
bool	get_joint_limits (const std::string &joint_name, const rclcpp_lifecycle::LifecycleNode::SharedPtr &lifecycle_node, SoftJointLimits &soft_limits)
bool	check_for_limits_update (const std::string &joint_name, const std::vector< rclcpp::Parameter > &parameters, const rclcpp::node_interfaces::NodeLoggingInterface::SharedPtr &logging_itf, SoftJointLimits &updated_limits)
bool	getJointLimits (urdf::JointConstSharedPtr urdf_joint, JointLimits &limits)
	Populate a JointLimits instance from URDF joint data. More...
bool	getSoftJointLimits (urdf::JointConstSharedPtr urdf_joint, SoftJointLimits &soft_limits)
	Populate a SoftJointLimits instance from URDF joint data. More...

Detailed Description

Author

Denis Stogl

Adolfo Rodriguez Tsouroukdissian

Dr. Denis Stogl

Function Documentation

check_for_limits_update() [1/2]

bool joint_limits::check_for_limits_update ( const std::string &  joint_name, const std::vector< rclcpp::Parameter > &  parameters, const rclcpp::node_interfaces::NodeLoggingInterface::SharedPtr &  logging_itf, JointLimits &  updated_limits  )

inline

Check if any of updated parameters are related to JointLimits.

This method is intended to be used in the parameters update callback. It is recommended that it's result is temporarily stored and synchronized with the JointLimits structure in the main loop.

Parameters

[in]	joint_name	Name of the joint whose limits should be checked.
[in]	parameters	List of the parameters that should be checked if they belong to this structure and that are used for updating the internal values.
[in]	logging_itf	node logging interface to provide log errors.
[out]	updated_limits	structure with updated JointLimits. It is recommended that the currently used limits are stored into this structure before calling this method.

check_for_limits_update() [2/2]

bool joint_limits::check_for_limits_update ( const std::string &  joint_name, const std::vector< rclcpp::Parameter > &  parameters, const rclcpp::node_interfaces::NodeLoggingInterface::SharedPtr &  logging_itf, SoftJointLimits &  updated_limits  )

inline

Check if any of updated parameters are related to SoftJointLimits.

This method is intended to be used in the parameters update callback. It is recommended that it's result is temporarily stored and synchronized with the SoftJointLimits structure in the main loop.

Parameters

[in]	joint_name	Name of the joint whose limits should be checked.
[in]	parameters	List of the parameters that should be checked if they belong to this structure and that are used for updating the internal values.
[in]	logging_itf	node logging interface to provide log errors.
[out]	updated_limits	structure with updated SoftJointLimits. It is recommended that the currently used limits are stored into this structure before calling this method.

declare_parameters() [1/3]

bool joint_limits::declare_parameters ( const std::string &  joint_name, const rclcpp::Node::SharedPtr &  node  )

inline

Declare JointLimits and SoftJointLimits parameters for joint with joint_name for the node object. This is a convenience function. For parameters structure see the underlying declare_parameters function.

Parameters

[in]	joint_name	name of the joint for which parameters will be declared.
[in]	node	node for parameters should be declared.

Returns

True if parameters are successfully declared, false otherwise.

declare_parameters() [2/3]

bool joint_limits::declare_parameters ( const std::string &  joint_name, const rclcpp::node_interfaces::NodeParametersInterface::SharedPtr &  param_itf, const rclcpp::node_interfaces::NodeLoggingInterface::SharedPtr &  logging_itf  )

inline

Declare JointLimits and SoftJointLimits parameters for joint with joint_name using node parameters interface param_itf.

The following parameter structure is declared with base name joint_limits.joint_name:

has_position_limits: bool
min_position: double
max_position: double
has_velocity_limits: bool
max_velocity: double
has_acceleration_limits: bool
max_acceleration: double
has_deceleration_limits: bool
max_deceleration: double
has_jerk_limits: bool
max_jerk: double
has_effort_limits: bool
max_effort: double
angle_wraparound: bool
has_soft_limits: bool
k_position: double
k_velocity: double
soft_lower_limit: double
soft_upper_limit: double

Parameters

[in]	joint_name	name of the joint for which parameters will be declared.
[in]	param_itf	node parameters interface object to access parameters.
[in]	logging_itf	node logging interface to log if error happens.

Returns

True if parameters are successfully declared, false otherwise.

declare_parameters() [3/3]

bool joint_limits::declare_parameters ( const std::string &  joint_name, const rclcpp_lifecycle::LifecycleNode::SharedPtr &  lifecycle_node  )

inline

Declare JointLimits and SoftJointLimits parameters for joint with joint_name for the lifecycle_node object. This is a convenience function. For parameters structure see the underlying declare_parameters function.

Parameters

[in]	joint_name	name of the joint for which parameters will be declared.
[in]	lifecycle_node	lifecycle node for parameters should be declared.

Returns

True if parameters are successfully declared, false otherwise.

get_joint_limits() [1/6]

bool joint_limits::get_joint_limits ( const std::string &  joint_name, const rclcpp::Node::SharedPtr &  node, JointLimits &  limits  )

inline

Populate a JointLimits instance from the node parameters. This is a convenience function. For parameters structure see the underlying get_joint_limits function.

Parameters

[in]	joint_name	Name of joint whose limits are to be fetched.
[in]	node	Node object for which parameters should be fetched.
[out]	limits	Where joint limit data gets written into. Limits specified in the parameter server will overwrite existing values. Values in limits not specified in the parameter server remain unchanged.

Returns

True if a limits specification is found, false otherwise.

get_joint_limits() [2/6]

bool joint_limits::get_joint_limits ( const std::string &  joint_name, const rclcpp::Node::SharedPtr &  node, SoftJointLimits &  soft_limits  )

inline

Populate a JointLimits instance from the node parameters. This is a convenience function. For parameters structure see the underlying get_joint_limits function.

Parameters

[in]	joint_name	Name of joint whose limits are to be fetched.
[in]	node	Node object for which parameters should be fetched.
[out]	soft_limits	Where soft joint limit data gets written into. Limits specified in the parameter server will overwrite existing values.

Returns

True if a soft limits specification is found, false otherwise.

get_joint_limits() [3/6]

bool joint_limits::get_joint_limits ( const std::string &  joint_name, const rclcpp::node_interfaces::NodeParametersInterface::SharedPtr &  param_itf, const rclcpp::node_interfaces::NodeLoggingInterface::SharedPtr &  logging_itf, JointLimits &  limits  )

inline

Populate a JointLimits instance from the node parameters.

It is assumed that parameter structure is the following:

has_position_limits: bool
min_position: double
max_position: double
has_velocity_limits: bool
max_velocity: double
has_acceleration_limits: bool
max_acceleration: double
has_deceleration_limits: bool
max_deceleration: double
has_jerk_limits: bool
max_jerk: double
has_effort_limits: bool
max_effort: double
angle_wraparound: bool  # will be ignored if there are position limits

Unspecified parameters are not added to the joint limits specification. A specification in a yaml would look like this:

<node_name>
  ros__parameters:
    joint_limits:
      foo_joint:
        has_position_limits: true
        min_position: 0.0
        max_position: 1.0
        has_velocity_limits: true
        max_velocity: 2.0
        has_acceleration_limits: true
        max_acceleration: 5.0
        has_deceleration_limits: true
        max_deceleration: 7.5
        has_jerk_limits: true
        max_jerk: 100.0
        has_effort_limits: true
        max_effort: 20.0
      bar_joint:
        has_position_limits: false   # Continuous joint
        angle_wraparound: true       # available only for continuous joints
        has_velocity_limits: true
        max_velocity: 4.0

Parameters

[in]	joint_name	Name of joint whose limits are to be fetched, e.g., "foo_joint".
[in]	param_itf	node parameters interface of the node where parameters are specified.
[in]	logging_itf	node logging interface to provide log errors.
[out]	limits	Where joint limit data gets written into. Limits specified in the parameter server will overwrite existing values. Values in limits not specified in the parameter server remain unchanged.

Returns

True if a limits specification is found (i.e., the joint_limits/joint_name parameter exists in node), false otherwise.

get_joint_limits() [4/6]

bool joint_limits::get_joint_limits ( const std::string &  joint_name, const rclcpp::node_interfaces::NodeParametersInterface::SharedPtr &  param_itf, const rclcpp::node_interfaces::NodeLoggingInterface::SharedPtr &  logging_itf, SoftJointLimits &  soft_limits  )

inline

Populate a SoftJointLimits instance from the ROS parameter server.

It is assumed that the parameter structure is the following:

has_soft_limits: bool
k_position: double
k_velocity: double
soft_lower_limit: double
soft_upper_limit: double

Only completely specified soft joint limits specifications will be considered valid. For example a valid yaml configuration would look like:

<node_name>
  ros__parameters:
    joint_limits:
      foo_joint:
        soft_lower_limit: 0.0
        soft_upper_limit: 1.0
        k_position: 10.0
        k_velocity: 10.0

Parameters

[in]	joint_name	Name of joint whose limits are to be fetched, e.g., "foo_joint".
[in]	param_itf	node parameters interface of the node where parameters are specified.
[in]	logging_itf	node logging interface to provide log errors.
[out]	soft_limits	Where soft joint limit data gets written into. Limits specified in the parameter server will overwrite existing values.

Returns

True if a complete soft limits specification is found (ie. if all k_position, k_velocity, soft_lower_limit and soft_upper_limit exist in joint_limits/joint_name namespace), false otherwise.

get_joint_limits() [5/6]

bool joint_limits::get_joint_limits ( const std::string &  joint_name, const rclcpp_lifecycle::LifecycleNode::SharedPtr &  lifecycle_node, JointLimits &  limits  )

inline

Populate a JointLimits instance from the node parameters. This is a convenience function. For parameters structure see the underlying get_joint_limits function.

Parameters

[in]	joint_name	Name of joint whose limits are to be fetched.
[in]	lifecycle_node	Lifecycle node object for which parameters should be fetched.
[out]	limits	Where joint limit data gets written into. Limits specified in the parameter server will overwrite existing values. Values in limits not specified in the parameter server remain unchanged.

Returns

True if a limits specification is found, false otherwise.

get_joint_limits() [6/6]

bool joint_limits::get_joint_limits ( const std::string &  joint_name, const rclcpp_lifecycle::LifecycleNode::SharedPtr &  lifecycle_node, SoftJointLimits &  soft_limits  )

inline

Populate a JointLimits instance from the node parameters. This is a convenience function. For parameters structure see the underlying get_joint_limits function.

Parameters

[in]	joint_name	Name of joint whose limits are to be fetched.
[in]	lifecycle_node	Lifecycle node object for which parameters should be fetched.
[out]	soft_limits	Where soft joint limit data gets written into. Limits specified in the parameter server will overwrite existing values.

Returns

True if a soft limits specification is found, false otherwise.

getJointLimits()

bool joint_limits::getJointLimits ( urdf::JointConstSharedPtr  urdf_joint, JointLimits &  limits  )

inline

Populate a JointLimits instance from URDF joint data.

Parameters

[in]	urdf_joint	URDF joint.
[out]	limits	Where URDF joint limit data gets written into. Limits in urdf_joint will overwrite existing values. Values in limits not present in urdf_joint remain unchanged.

Returns

True if urdf_joint has a valid limits specification, false otherwise.

getSoftJointLimits()

bool joint_limits::getSoftJointLimits ( urdf::JointConstSharedPtr  urdf_joint, SoftJointLimits &  soft_limits  )

inline

Populate a SoftJointLimits instance from URDF joint data.

Parameters

[in]	urdf_joint	URDF joint.
[out]	soft_limits	Where URDF soft joint limit data gets written into.

Returns

True if urdf_joint has a valid soft limits specification, false otherwise.