ODESliderJoint Class Reference

A slider joint. More...

#include <ODESliderJoint.hh>

Inherits SliderJoint< ODEJoint >.

Public Types

enum  Attribute {
  FUDGE_FACTOR, SUSPENSION_ERP, SUSPENSION_CFM, STOP_ERP,
  STOP_CFM, ERP, CFM, FMAX,
  VEL, HI_STOP, LO_STOP
}
 Joint attribute types. More...
 
enum  CFMMode { NONE = 0x00000000, DAMPING_ACTIVE = 0x00000001, JOINT_LIMIT = 0x00000002 }
 internal variables used for implicit damping More...
 
enum  EntityType {
  BASE = 0x00000000, ENTITY = 0x00000001, MODEL = 0x00000002, LINK = 0x00000004,
  COLLISION = 0x00000008, LIGHT = 0x00000010, VISUAL = 0x00000020, JOINT = 0x00000040,
  BALL_JOINT = 0x00000080, HINGE2_JOINT = 0x00000100, HINGE_JOINT = 0x00000200, SLIDER_JOINT = 0x00000400,
  SCREW_JOINT = 0x00000800, UNIVERSAL_JOINT = 0x00001000, GEARBOX_JOINT = 0x00002000, FIXED_JOINT = 0x00004000,
  ACTOR = 0x00008000, SHAPE = 0x00010000, BOX_SHAPE = 0x00020000, CYLINDER_SHAPE = 0x00040000,
  HEIGHTMAP_SHAPE = 0x00080000, MAP_SHAPE = 0x00100000, MULTIRAY_SHAPE = 0x00200000, RAY_SHAPE = 0x00400000,
  PLANE_SHAPE = 0x00800000, SPHERE_SHAPE = 0x01000000, MESH_SHAPE = 0x02000000, POLYLINE_SHAPE = 0x04000000,
  SENSOR_COLLISION = 0x10000000
}
 Unique identifiers for all entity types. More...
 

Public Member Functions

 ODESliderJoint (dWorldID _worldId, BasePtr _parent)
 Constructor. More...
 
virtual ~ODESliderJoint ()
 Destructor. More...
 
void AddChild (BasePtr _child)
 Add a child to this entity. More...
 
void AddType (EntityType _type)
 Add a type specifier. More...
 
virtual ignition::math::Vector3d Anchor (const unsigned int _index) const
 Get the anchor point. More...
 
ignition::math::Pose3d AnchorErrorPose () const
 Get pose offset between anchor pose on child and parent, expressed in the parent link frame. More...
 
void ApplyExplicitStiffnessDamping ()
 simulating a joint spring and damper explicitly. More...
 
void ApplyImplicitStiffnessDamping ()
 simulate implicit spring and damper with CFM/ERP and meddling with Joint limits. More...
 
virtual void ApplyStiffnessDamping () override
 Callback to apply spring stiffness and viscous damping effects to joint. More...
 
virtual bool AreConnected (LinkPtr _one, LinkPtr _two) const override
 Determines of the two bodies are connected by a joint. More...
 
virtual void Attach (LinkPtr _parent, LinkPtr _child) override
 Attach the two bodies with this joint. More...
 
ignition::math::Quaterniond AxisFrame (const unsigned int _index) const
 Get orientation of reference frame for specified axis, relative to world frame. More...
 
ignition::math::Quaterniond AxisFrameOffset (const unsigned int _index) const
 Get orientation of joint axis reference frame relative to joint frame. More...
 
virtual void CacheForceTorque () override
 Cache Joint Force Torque Values if necessary for physics engine. More...
 
double CheckAndTruncateForce (unsigned int _index, double _effort)
 check if the force against velocityLimit and effortLimit, truncate if necessary. More...
 
template<typename T >
event::ConnectionPtr ConnectJointUpdate (T _subscriber)
 Connect a boost::slot the the joint update signal. More...
 
virtual void Detach () override
 Detach this joint from all links. More...
 
virtual unsigned int DOF () const
 
virtual void FillMsg (msgs::Joint &_msg)
 Fill a joint message. More...
 
virtual void Fini () override
 Finialize the object. More...
 
BasePtr GetByName (const std::string &_name)
 Get by name. More...
 
double GetCFM ()
 Get the CFM of this joint. More...
 
BasePtr GetChild (unsigned int _i) const
 Get a child by index. More...
 
BasePtr GetChild (const std::string &_name)
 Get a child by name. More...
 
LinkPtr GetChild () const
 Get the child link. More...
 
unsigned int GetChildCount () const
 Get the number of children. More...
 
double GetDamping (unsigned int _index)
 Returns the current joint damping coefficient. More...
 
virtual double GetEffortLimit (unsigned int _index)
 Get the effort limit on axis(index). More...
 
double GetERP ()
 Get the ERP of this joint. More...
 
dJointFeedback * GetFeedback ()
 Get the feedback data structure for this joint, if set. More...
 
virtual double GetForce (unsigned int _index) override
 
virtual JointWrench GetForceTorque (unsigned int _index) override
 get internal force and torque values at a joint. More...
 
uint32_t GetId () const
 Return the ID of this entity. More...
 
double GetInertiaRatio (const unsigned int _index) const
 Computes moment of inertia (MOI) across a specified joint axis. More...
 
virtual LinkPtr GetJointLink (unsigned int _index) const override
 Get the link to which the joint is attached according the _index. More...
 
msgs::Joint::Type GetMsgType () const
 Get the joint type as msgs::Joint::Type. More...
 
std::string GetName () const
 Return the name of the entity. More...
 
virtual double GetParam (unsigned int _parameter) const
 Get an ODE joint parameter. More...
 
virtual double GetParam (const std::string &_key, unsigned int _index) override
 Get a non-generic parameter for the joint. More...
 
LinkPtr GetParent () const
 Get the parent link. More...
 
int GetParentId () const
 Return the ID of the parent. More...
 
bool GetSaveable () const
 Get whether the object should be "saved", when the user selects to save the world to xml. More...
 
std::string GetScopedName (bool _prependWorldName=false) const
 Return the name of this entity with the model scope model1::...::modelN::entityName. More...
 
virtual const sdf::ElementPtr GetSDF ()
 Get the SDF values for the object. More...
 
const sdf::Joint * GetSDFDom () const
 Get the SDF DOM object of this joint. More...
 
double GetSpringReferencePosition (unsigned int _index) const
 Get joint spring reference position. More...
 
double GetStiffness (unsigned int _index)
 Returns the current joint spring stiffness coefficient. More...
 
double GetStopCFM ()
 Get access to stopCFM. More...
 
double GetStopDissipation (unsigned int _index) const
 Get joint stop dissipation. More...
 
double GetStopERP ()
 Get access to stopERP. More...
 
double GetStopStiffness (unsigned int _index) const
 Get joint stop stiffness. More...
 
unsigned int GetType () const
 Get the full type definition. More...
 
virtual double GetVelocity (unsigned int _index) const
 Get the rotation rate of an axis(index) More...
 
virtual double GetVelocityLimit (unsigned int _index)
 Get the velocity limit on axis(index). More...
 
const WorldPtrGetWorld () const
 Get the World this object is in. More...
 
double GetWorldEnergyPotentialSpring (unsigned int _index) const
 Returns this joint's spring potential energy, based on the reference position of the spring. More...
 
virtual ignition::math::Vector3d GlobalAxis (const unsigned int _index) const
 Get the axis of rotation in global cooridnate frame. More...
 
bool HasType (const EntityType &_t) const
 Returns true if this object's type definition has the given type. More...
 
double InertiaRatio (const ignition::math::Vector3d &_axis) const
 Computes moment of inertia (MOI) across an arbitrary axis specified in the world frame. More...
 
virtual void Init () override
 Initialize a joint. More...
 
ignition::math::Pose3d InitialAnchorPose () const
 Get initial Anchor Pose specified by model <joint><pose>...</pose></joint> More...
 
bool IsSelected () const
 True if the entity is selected by the user. More...
 
virtual ignition::math::Vector3d LinkForce (const unsigned int _index) const override
 Get the forces applied to the center of mass of a physics::Link due to the existence of this Joint. More...
 
virtual ignition::math::Vector3d LinkTorque (const unsigned int _index) const override
 Get the torque applied to the center of mass of a physics::Link due to the existence of this Joint. More...
 
virtual void Load (sdf::ElementPtr _sdf)
 Load a SliderJoint. More...
 
void Load (LinkPtr _parent, LinkPtr _child, const ignition::math::Pose3d &_pose)
 Set pose, parent and child links of a physics::Joint. More...
 
ignition::math::Vector3d LocalAxis (const unsigned int _index) const
 Get the axis of rotation. More...
 
virtual double LowerLimit (unsigned int _index=0) const
 Get the joint's lower limit. More...
 
bool operator== (const Base &_ent) const
 Returns true if the entities are the same. More...
 
ignition::math::Pose3d ParentWorldPose () const
 Get anchor pose on parent link relative to world frame. More...
 
virtual double Position (const unsigned int _index=0) const final
 Get the position of an axis according to its index. More...
 
virtual double PositionImpl (const unsigned int _index) const
 Helper function to get the position of an axis. More...
 
void Print (const std::string &_prefix)
 Print this object to screen via gzmsg. More...
 
virtual void RemoveChild (unsigned int _id)
 Remove a child from this entity. More...
 
void RemoveChild (const std::string &_name)
 Remove a child by name. More...
 
void RemoveChild (physics::BasePtr _child)
 Remove a child by pointer. More...
 
void RemoveChildren ()
 Remove all children. More...
 
virtual void Reset () override
 Reset the joint. More...
 
virtual void Reset (Base::EntityType _resetType)
 Calls recursive Reset on one of the Base::EntityType's. More...
 
ignition::math::Vector3d ResolveAxisXyz (const unsigned int _index, const std::string &_resolveTo="") const
 Resolve axis xyz value to the named frame, defaulting to the joint frame if no frame name is supplied. More...
 
ignition::math::Pose3d SDFPoseRelativeToParent () const
 Get the SDF pose of the object according to the sdf 1.6 convention. More...
 
virtual std::optional< sdf::SemanticPose > SDFSemanticPose () const override
 Get the SDF SemanticPose object associated with the pose of this object. More...
 
virtual void SetAnchor (const unsigned int _index, const ignition::math::Vector3d &_anchor)
 Set the anchor point. More...
 
virtual void SetAxis (const unsigned int _index, const ignition::math::Vector3d &_axis)
 Set the axis of rotation where axis is specified in local joint frame. More...
 
void SetCFM (double _cfm)
 Set the CFM of this joint. More...
 
virtual void SetDamping (unsigned int _index, double _damping) override
 Set the joint damping. More...
 
virtual void SetEffortLimit (unsigned int _index, double _effort)
 Set the effort limit on a joint axis. More...
 
void SetERP (double _erp)
 Set the ERP of this joint. More...
 
virtual void SetForce (unsigned int _index, double _force) override
 Set the force applied to this physics::Joint. More...
 
virtual void SetLowerLimit (const unsigned int _index, const double _limit) override
 Set the joint's lower limit. More...
 
void SetModel (ModelPtr _model)
 Set the model this joint belongs too. More...
 
virtual void SetName (const std::string &_name)
 Set the name of the entity. More...
 
virtual void SetParam (unsigned int _parameter, double _value)
 Set an ODE joint paramter. More...
 
virtual bool SetParam (const std::string &_key, unsigned int _index, const boost::any &_value) override
 Set a non-generic parameter for the joint. More...
 
void SetParent (BasePtr _parent)
 Set the parent. More...
 
virtual bool SetPosition (const unsigned int _index, const double _position, const bool _preserveWorldVelocity=false) override
 The child links of this joint are updated based on desired position. More...
 
virtual void SetProvideFeedback (bool _enable) override
 Set whether the joint should generate feedback. More...
 
void SetSaveable (bool _v)
 Set whether the object should be "saved", when the user selects to save the world to xml. More...
 
virtual bool SetSelected (bool _show)
 Set whether this entity has been selected by the user through the gui. More...
 
void SetState (const JointState &_state)
 Set the joint state. More...
 
virtual void SetStiffness (unsigned int _index, const double _stiffness) override
 Set the joint spring stiffness. More...
 
virtual void SetStiffnessDamping (unsigned int _index, double _stiffness, double _damping, double _reference=0) override
 Set the joint spring stiffness. More...
 
void SetStopDissipation (unsigned int _index, double _dissipation)
 Set joint stop dissipation. More...
 
void SetStopStiffness (unsigned int _index, double _stiffness)
 Set joint stop stiffness. More...
 
virtual void SetUpperLimit (const unsigned int _index, const double _limit) override
 Set the joint's upper limit. More...
 
virtual void SetVelocity (unsigned int _index, double _angle)
 Set the velocity of an axis(index). More...
 
virtual void SetVelocityLimit (unsigned int _index, double _velocity)
 Set the velocity limit on a joint axis. More...
 
void SetWorld (const WorldPtr &_newWorld)
 Set the world this object belongs to. More...
 
std::string TypeStr () const
 Get the string name for the entity type. More...
 
void Update () override
 Update the joint. More...
 
virtual void UpdateParameters (sdf::ElementPtr _sdf) override
 Update the parameters using new sdf values. More...
 
virtual double UpperLimit (const unsigned int _index=0) const
 Get the joint's upper limit. More...
 
common::URI URI () const
 Return the common::URI of this entity. More...
 
void UseImplicitSpringDamper (const bool _implicit)
 Set flag indicating whether implicit spring damper is enabled. More...
 
bool UsesImplicitSpringDamper ()
 Get flag indicating whether implicit spring damper is enabled. More...
 
ignition::math::Pose3d WorldPose () const
 Get pose of joint frame relative to world frame. More...
 

Protected Member Functions

ignition::math::Pose3d ChildLinkPose (const unsigned int _index, const double _position)
 internal function to help us compute child link pose if a joint position change is applied. More...
 
void ComputeScopedName ()
 Compute the scoped name of this object based on its parents. More...
 
bool FindAllConnectedLinks (const LinkPtr &_originalParentLink, Link_V &_connectedLinks)
 internal helper to find all links connected to the child link branching out from the children of the child link and any parent of the child link other than the parent link through this joint. More...
 
virtual void RegisterIntrospectionItems () override
 Register items in the introspection service. More...
 
virtual void SetForceImpl (unsigned int _index, double _effort)
 Set the force applied to this physics::Joint. More...
 
bool SetPositionMaximal (const unsigned int _index, double _position, const bool _preserveWorldVelocity=false)
 Helper function for maximal coordinate solver SetPosition. More...
 
bool SetVelocityMaximal (unsigned int _index, double _velocity)
 Helper function for maximal coordinate solver SetVelocity. More...
 
virtual void UnregisterIntrospectionItems ()
 Unregister items in the introspection service. More...
 

Protected Attributes

LinkPtr anchorLink
 Anchor link. More...
 
ignition::math::Vector3d anchorPos
 Anchor pose. More...
 
ignition::math::Pose3d anchorPose
 Anchor pose specified in SDF <joint><pose> tag. More...
 
double angleOffset [MAX_JOINT_AXIS]
 Joint angle(s) when ODE joint has angle 0. More...
 
gazebo::event::ConnectionPtr applyDamping
 apply damping for adding viscous damping forces on updates More...
 
std::string axisExpressedIn [2]
 Expressed-in values for each axis that are checked if the DOM has errors. More...
 
LinkPtr childLink
 The first link this joint connects to. More...
 
Base_V children
 Children of this entity. More...
 
double dissipationCoefficient [2]
 joint viscous damping coefficient More...
 
double effortLimit [2]
 Store Joint effort limit as specified in SDF. More...
 
std::vector< common::URIintrospectionItems
 All the introspection items regsitered for this. More...
 
dJointID jointId
 This is our ODE ID. More...
 
double lowerLimit [2]
 Store Joint position lower limit as specified in SDF. More...
 
ModelPtr model
 Pointer to the parent model. More...
 
BasePtr parent
 Parent of this entity. More...
 
ignition::math::Pose3d parentAnchorPose
 Anchor pose relative to parent link frame. More...
 
LinkPtr parentLink
 The second link this joint connects to. More...
 
bool provideFeedback
 Provide Feedback data for contact forces. More...
 
sdf::ElementPtr sdf
 The SDF values for this object. More...
 
double springReferencePosition [2]
 joint spring reference (zero load) position More...
 
double stiffnessCoefficient [2]
 joint stiffnessCoefficient More...
 
double upperLimit [2]
 Store Joint position upper limit as specified in SDF. More...
 
double velocityLimit [2]
 Store Joint velocity limit as specified in SDF. More...
 
WorldPtr world
 Pointer to the world. More...
 
JointWrench wrench
 Cache Joint force torque values in case physics engine clears them at the end of update step. More...
 

Detailed Description

A slider joint.

Member Enumeration Documentation

◆ Attribute

enum Attribute
inherited

Joint attribute types.

Enumerator
FUDGE_FACTOR 

Fudge factor.

SUSPENSION_ERP 

Suspension error reduction parameter.

SUSPENSION_CFM 

Suspension constraint force mixing.

STOP_ERP 

Stop limit error reduction parameter.

STOP_CFM 

Stop limit constraint force mixing.

ERP 

Error reduction parameter.

CFM 

Constraint force mixing.

FMAX 

Maximum force.

VEL 

Velocity.

HI_STOP 

Upper joint limit.

LO_STOP 

Lower joint limit.

◆ CFMMode

enum CFMMode
inherited

internal variables used for implicit damping

Enumerator
NONE 

implicit damping not active

DAMPING_ACTIVE 

implicit damping active, joints within limits

JOINT_LIMIT 

implicit damping not active, enforcing joints limits

◆ EntityType

enum EntityType
inherited

Unique identifiers for all entity types.

Enumerator
BASE 

Base type.

ENTITY 

Entity type.

MODEL 

Model type.

LINK 

Link type.

COLLISION 

Collision type.

LIGHT 

Light type.

VISUAL 

Visual type.

JOINT 

Joint type.

BALL_JOINT 

BallJoint type.

HINGE2_JOINT 

Hing2Joint type.

HINGE_JOINT 

HingeJoint type.

SLIDER_JOINT 

SliderJoint type.

SCREW_JOINT 

ScrewJoint type.

UNIVERSAL_JOINT 

UniversalJoint type.

GEARBOX_JOINT 

GearboxJoint type.

FIXED_JOINT 

FixedJoint type.

ACTOR 

Actor type.

SHAPE 

Shape type.

BOX_SHAPE 

BoxShape type.

CYLINDER_SHAPE 

CylinderShape type.

HEIGHTMAP_SHAPE 

HeightmapShape type.

MAP_SHAPE 

MapShape type.

MULTIRAY_SHAPE 

MultiRayShape type.

RAY_SHAPE 

RayShape type.

PLANE_SHAPE 

PlaneShape type.

SPHERE_SHAPE 

SphereShape type.

MESH_SHAPE 

MeshShape type.

POLYLINE_SHAPE 

PolylineShape type.

SENSOR_COLLISION 

Indicates a collision shape used for sensing.

Constructor & Destructor Documentation

◆ ODESliderJoint()

ODESliderJoint ( dWorldID  _worldId,
BasePtr  _parent 
)

Constructor.

Parameters
[in]_worldIdODE world id.
[in]_parentPointer to the Link that is the joint' parent

◆ ~ODESliderJoint()

virtual ~ODESliderJoint ( )
virtual

Destructor.

Member Function Documentation

◆ AddChild()

void AddChild ( BasePtr  _child)
inherited

Add a child to this entity.

Parameters
[in]_childChild entity.

Referenced by Base::Update().

◆ AddType()

void AddType ( EntityType  _type)
inherited

Add a type specifier.

Parameters
[in]_typeNew type to append to this objects type definition.

Referenced by Base::Update().

◆ Anchor()

virtual ignition::math::Vector3d Anchor ( const unsigned int  _index) const
virtual

Get the anchor point.

Parameters
[in]_indexIndex of the axis.
Returns
Anchor value for the axis.

Implements Joint.

◆ AnchorErrorPose()

ignition::math::Pose3d AnchorErrorPose ( ) const
inherited

Get pose offset between anchor pose on child and parent, expressed in the parent link frame.

This can be used to compute the bilateral constraint error.

Returns
Pose offset between anchor pose on child and parent, in parent link frame.

Referenced by Joint::ConnectJointUpdate().

◆ ApplyExplicitStiffnessDamping()

void ApplyExplicitStiffnessDamping ( )
inherited

simulating a joint spring and damper explicitly.

◆ ApplyImplicitStiffnessDamping()

void ApplyImplicitStiffnessDamping ( )
inherited

simulate implicit spring and damper with CFM/ERP and meddling with Joint limits.

◆ ApplyStiffnessDamping()

virtual void ApplyStiffnessDamping ( )
overridevirtualinherited

Callback to apply spring stiffness and viscous damping effects to joint.

: rename to ApplySpringStiffnessDamping()

Reimplemented from Joint.

Referenced by ODEJoint::GetStopERP().

◆ AreConnected()

virtual bool AreConnected ( LinkPtr  _one,
LinkPtr  _two 
) const
overridevirtualinherited

Determines of the two bodies are connected by a joint.

Parameters
[in]_oneFirst link.
[in]_twoSecond link.
Returns
True if the two links are connected by a joint.

Implements Joint.

◆ Attach()

virtual void Attach ( LinkPtr  _parent,
LinkPtr  _child 
)
overridevirtualinherited

Attach the two bodies with this joint.

Parameters
[in]_parentParent link.
[in]_childChild link.

Reimplemented from Joint.

Reimplemented in ODEFixedJoint.

◆ AxisFrame()

ignition::math::Quaterniond AxisFrame ( const unsigned int  _index) const
inherited

Get orientation of reference frame for specified axis, relative to world frame.

The value of axisParentModelFrame is used to determine the appropriate frame.

Parameters
[in]_indexjoint axis index.
Returns
Orientation of axis frame relative to world frame.

Referenced by Joint::ConnectJointUpdate().

◆ AxisFrameOffset()

ignition::math::Quaterniond AxisFrameOffset ( const unsigned int  _index) const
inherited

Get orientation of joint axis reference frame relative to joint frame.

This should always return identity unless flag use_parent_model_frame is true in sdf 1.5 or using sdf 1.4-, i.e. bug described in issue #494 is present. In addition, if use_parent_model_frame is true, and the parent link of the joint is world, the axis is defined in the world frame. The value of axisParentModelFrame is used to determine the appropriate frame internally.

Parameters
[in]_indexjoint axis index.
Returns
Orientation of axis frame relative to joint frame. If supplied _index is out of range, or use_parent_model_frame is not true, this function returns identity rotation quaternion.

Referenced by Joint::ConnectJointUpdate().

◆ CacheForceTorque()

virtual void CacheForceTorque ( )
overridevirtualinherited

Cache Joint Force Torque Values if necessary for physics engine.

Reimplemented from Joint.

◆ CheckAndTruncateForce()

double CheckAndTruncateForce ( unsigned int  _index,
double  _effort 
)
inherited

check if the force against velocityLimit and effortLimit, truncate if necessary.

Parameters
[in]_indexIndex of the axis.
[in]_effortForce value.
Returns
truncated effort

Referenced by Joint::ConnectJointUpdate().

◆ ChildLinkPose()

ignition::math::Pose3d ChildLinkPose ( const unsigned int  _index,
const double  _position 
)
protectedinherited

internal function to help us compute child link pose if a joint position change is applied.

Parameters
[in]_indexaxis index
[in]_positionnew joint position
Returns
new child link pose at new joint position.

Referenced by Joint::ConnectJointUpdate().

◆ ComputeScopedName()

void ComputeScopedName ( )
protectedinherited

Compute the scoped name of this object based on its parents.

See also
Base::GetScopedName

Referenced by Base::Update().

◆ ConnectJointUpdate()

event::ConnectionPtr ConnectJointUpdate ( _subscriber)
inlineinherited

◆ Detach()

virtual void Detach ( )
overridevirtualinherited

Detach this joint from all links.

Reimplemented from Joint.

◆ DOF()

virtual unsigned int DOF ( ) const
inlinevirtualinherited

Implements Joint.

◆ FillMsg()

virtual void FillMsg ( msgs::Joint &  _msg)
virtualinherited

◆ FindAllConnectedLinks()

bool FindAllConnectedLinks ( const LinkPtr _originalParentLink,
Link_V _connectedLinks 
)
protectedinherited

internal helper to find all links connected to the child link branching out from the children of the child link and any parent of the child link other than the parent link through this joint.

Parameters
[in]_originalParentLinkparent link of this joint, this is used to check for loops connecting back to the parent link.

Referenced by Joint::ConnectJointUpdate().

◆ Fini()

virtual void Fini ( )
overridevirtualinherited

Finialize the object.

Reimplemented from Joint.

◆ GetByName()

BasePtr GetByName ( const std::string &  _name)
inherited

Get by name.

Parameters
[in]_nameGet a child (or self) object by name
Returns
A pointer to the object, NULL if not found

Referenced by Base::Update().

◆ GetCFM()

double GetCFM ( )
inherited

Get the CFM of this joint.

Returns
The Constraint Force Mixing value

◆ GetChild() [1/3]

BasePtr GetChild ( unsigned int  _i) const
inherited

Get a child by index.

Parameters
[in]_iIndex of the child to retreive.
Returns
A pointer to the object, NULL if the index is invalid.

Referenced by Base::Update().

◆ GetChild() [2/3]

BasePtr GetChild ( const std::string &  _name)
inherited

Get a child by name.

Parameters
[in]_nameName of the child.
Returns
A pointer to the object, NULL if not found

◆ GetChild() [3/3]

LinkPtr GetChild ( ) const
inherited

Get the child link.

Returns
Pointer to the child link.

Referenced by Joint::ConnectJointUpdate().

◆ GetChildCount()

unsigned int GetChildCount ( ) const
inherited

Get the number of children.

Returns
The number of children.

Referenced by Base::Update().

◆ GetDamping()

double GetDamping ( unsigned int  _index)
inherited

Returns the current joint damping coefficient.

Parameters
[in]_indexIndex of the axis to get, currently ignored, to be implemented.
Returns
Joint viscous damping coefficient for this joint.

◆ GetEffortLimit()

virtual double GetEffortLimit ( unsigned int  _index)
virtualinherited

Get the effort limit on axis(index).

Parameters
[in]_indexIndex of axis, where 0=first axis and 1=second axis
Returns
Effort limit specified in SDF

Referenced by Joint::ConnectJointUpdate().

◆ GetERP()

double GetERP ( )
inherited

Get the ERP of this joint.

Returns
The Error Reduction Parameter of this joint

◆ GetFeedback()

dJointFeedback* GetFeedback ( )
inherited

Get the feedback data structure for this joint, if set.

Returns
Pointer to the joint feedback.

◆ GetForce()

virtual double GetForce ( unsigned int  _index)
overridevirtualinherited
Todo:
: not yet implemented.

Get external forces applied at this Joint. Note that the unit of force should be consistent with the rest of the simulation scales.

Parameters
[in]_indexIndex of the axis.
Returns
The force applied to an axis.

Reimplemented from Joint.

Referenced by ODEJoint::GetStopERP().

◆ GetForceTorque()

virtual JointWrench GetForceTorque ( unsigned int  _index)
overridevirtualinherited

get internal force and torque values at a joint.

The force and torque values are returned in a JointWrench data structure. Where JointWrench.body1Force contains the force applied by the parent Link on the Joint specified in the parent Link frame, and JointWrench.body2Force contains the force applied by the child Link on the Joint specified in the child Link frame. Note that this sign convention is opposite of the reaction forces of the Joint on the Links.

FIXME TODO: change name of this function to something like: GetNegatedForceTorqueInLinkFrame and make GetForceTorque call return non-negated reaction forces in perspective Link frames.

Note that for ODE you must set <provide_feedback>true<provide_feedback> in the joint sdf to use this.

Parameters
[in]_indexNot used right now
Returns
The force and torque at the joint, see above for details on conventions.

Implements Joint.

Referenced by ODEJoint::GetStopERP().

◆ GetId()

uint32_t GetId ( ) const
inherited

Return the ID of this entity.

This id is unique.

Returns
Integer ID.

Referenced by Base::Update().

◆ GetInertiaRatio()

double GetInertiaRatio ( const unsigned int  _index) const
inherited

Computes moment of inertia (MOI) across a specified joint axis.

The ratio is given in the form of MOI_child / MOI_parent. If MOI_parent is zero, this funciton will return 0. The inertia ratio for each joint axis indicates the sensitivity of the joint to actuation torques.

Parameters
[in]_indexaxis number about which MOI ratio is computed.
Returns
ratio of child MOI to parent MOI.

Referenced by Joint::ConnectJointUpdate().

◆ GetJointLink()

virtual LinkPtr GetJointLink ( unsigned int  _index) const
overridevirtualinherited

Get the link to which the joint is attached according the _index.

Parameters
[in]_indexIndex of the link to retreive.
Returns
Pointer to the request link. NULL if the index was invalid.

Implements Joint.

◆ GetMsgType()

msgs::Joint::Type GetMsgType ( ) const
inherited

Get the joint type as msgs::Joint::Type.

Returns
Joint type.

Referenced by Joint::ConnectJointUpdate().

◆ GetName()

std::string GetName ( ) const
inherited

Return the name of the entity.

Returns
Name of the entity.

Referenced by Base::Update().

◆ GetParam() [1/2]

virtual double GetParam ( unsigned int  _parameter) const
virtual

Get an ODE joint parameter.

The default function does nothing. This should be overriden in the child classes where appropriate.

Parameters
[in]_parameterID of the parameter to get.
Returns
Value of the parameter.

Reimplemented from ODEJoint.

◆ GetParam() [2/2]

virtual double GetParam ( const std::string &  _key,
unsigned int  _index 
)
overridevirtualinherited

Get a non-generic parameter for the joint.

See also
SetParam(const std::string &, unsigned int, const boost::any)
Parameters
[in]_keyString key.
[in]_indexIndex of the axis.

Reimplemented from Joint.

Reimplemented in ODEScrewJoint, ODEUniversalJoint, and ODEGearboxJoint.

◆ GetParent()

LinkPtr GetParent ( ) const
inherited

Get the parent link.

Returns
Pointer to the parent link.

Referenced by Joint::ConnectJointUpdate().

◆ GetParentId()

int GetParentId ( ) const
inherited

Return the ID of the parent.

Returns
Integer ID.

Referenced by Base::Update().

◆ GetSaveable()

bool GetSaveable ( ) const
inherited

Get whether the object should be "saved", when the user selects to save the world to xml.

Returns
True if the object is saveable.

Referenced by Base::Update().

◆ GetScopedName()

std::string GetScopedName ( bool  _prependWorldName = false) const
inherited

Return the name of this entity with the model scope model1::...::modelN::entityName.

Parameters
[in]_prependWorldNameTrue to prended the returned string with the world name. The result will be world::model1::...::modelN::entityName.
Returns
The scoped name.

Referenced by Base::Update().

◆ GetSDF()

virtual const sdf::ElementPtr GetSDF ( )
virtualinherited

Get the SDF values for the object.

Returns
The SDF values for the object.

Reimplemented in Actor, and Model.

Referenced by Base::Update().

◆ GetSDFDom()

const sdf::Joint* GetSDFDom ( ) const
inherited

Get the SDF DOM object of this joint.

Returns
Pointer to SDF DOM Object

Referenced by Joint::ConnectJointUpdate().

◆ GetSpringReferencePosition()

double GetSpringReferencePosition ( unsigned int  _index) const
inherited

Get joint spring reference position.

Parameters
[in]_indexIndex of the axis to get.
Returns
Joint spring reference position (in radians for angular joints).

◆ GetStiffness()

double GetStiffness ( unsigned int  _index)
inherited

Returns the current joint spring stiffness coefficient.

Parameters
[in]_indexIndex of the axis to get, currently ignored, to be implemented.
Returns
Joint spring stiffness coefficient for this joint. : rename to GetSpringStiffness()

◆ GetStopCFM()

double GetStopCFM ( )
inlineinherited

Get access to stopCFM.

Returns
Returns joint's cfm for end stops

◆ GetStopDissipation()

double GetStopDissipation ( unsigned int  _index) const
inherited

Get joint stop dissipation.

Parameters
[in]_indexjoint axis index.
Returns
joint stop dissipation coefficient.

Referenced by Joint::ConnectJointUpdate().

◆ GetStopERP()

◆ GetStopStiffness()

double GetStopStiffness ( unsigned int  _index) const
inherited

Get joint stop stiffness.

Parameters
[in]_indexjoint axis index.
Returns
joint stop stiffness coefficient.

Referenced by Joint::ConnectJointUpdate().

◆ GetType()

unsigned int GetType ( ) const
inherited

Get the full type definition.

Returns
The full type definition.

Referenced by Base::Update().

◆ GetVelocity()

virtual double GetVelocity ( unsigned int  _index) const
virtual

Get the rotation rate of an axis(index)

Parameters
[in]_indexIndex of the axis.
Returns
The rotaional velocity of the joint axis.

Implements Joint.

◆ GetVelocityLimit()

virtual double GetVelocityLimit ( unsigned int  _index)
virtualinherited

Get the velocity limit on axis(index).

Parameters
[in]_indexIndex of axis, where 0=first axis and 1=second axis
Returns
Velocity limit specified in SDF

Referenced by Joint::ConnectJointUpdate().

◆ GetWorld()

const WorldPtr& GetWorld ( ) const
inherited

Get the World this object is in.

Returns
The World this object is part of.

Referenced by Base::Update().

◆ GetWorldEnergyPotentialSpring()

double GetWorldEnergyPotentialSpring ( unsigned int  _index) const
inherited

Returns this joint's spring potential energy, based on the reference position of the spring.

If using metric system, the unit of energy will be Joules.

Returns
this joint's spring potential energy,

Referenced by Joint::ConnectJointUpdate().

◆ GlobalAxis()

virtual ignition::math::Vector3d GlobalAxis ( const unsigned int  _index) const
virtual

Get the axis of rotation in global cooridnate frame.

Parameters
[in]_indexIndex of the axis to get.
Returns
Axis value for the provided index.

Implements Joint.

◆ HasType()

bool HasType ( const EntityType _t) const
inherited

Returns true if this object's type definition has the given type.

Parameters
[in]_tType to check.
Returns
True if this object's type definition has the.

Referenced by Base::Update().

◆ InertiaRatio()

double InertiaRatio ( const ignition::math::Vector3d &  _axis) const
inherited

Computes moment of inertia (MOI) across an arbitrary axis specified in the world frame.

The ratio is given in the form of MOI_chidl / MOI_parent. If MOI_parent is zero, this funciton will return 0. The moment of inertia ratio along constrained directions of a joint has an impact on the performance of Projected Gauss Seidel (PGS) iterative LCP methods.

Parameters
[in]_axisaxis in world frame for which MOI ratio is computed.
Returns
ratio of child MOI to parent MOI.

Referenced by Joint::ConnectJointUpdate().

◆ Init()

◆ InitialAnchorPose()

ignition::math::Pose3d InitialAnchorPose ( ) const
inherited

Get initial Anchor Pose specified by model <joint><pose>...</pose></joint>

Returns
Joint::anchorPose, initial joint anchor pose.

Referenced by Joint::ConnectJointUpdate().

◆ IsSelected()

bool IsSelected ( ) const
inherited

True if the entity is selected by the user.

Returns
True if the entity is selected.

Referenced by Base::Update().

◆ LinkForce()

virtual ignition::math::Vector3d LinkForce ( const unsigned int  _index) const
overridevirtualinherited

Get the forces applied to the center of mass of a physics::Link due to the existence of this Joint.

Note that the unit of force should be consistent with the rest of the simulation scales.

Parameters
[in]indexThe index of the link(0 or 1).
Returns
Force applied to the link.

Implements Joint.

Referenced by ODEJoint::GetStopERP().

◆ LinkTorque()

virtual ignition::math::Vector3d LinkTorque ( const unsigned int  _index) const
overridevirtualinherited

Get the torque applied to the center of mass of a physics::Link due to the existence of this Joint.

Note that the unit of torque should be consistent with the rest of the simulation scales.

Parameters
[in]indexThe index of the link(0 or 1)
Returns
Torque applied to the link.

Implements Joint.

Referenced by ODEJoint::GetStopERP().

◆ Load() [1/2]

virtual void Load ( sdf::ElementPtr  _sdf)
virtual

Load a SliderJoint.

Parameters
[in]_sdfSDF values to load from

Reimplemented from SliderJoint< ODEJoint >.

◆ Load() [2/2]

void Load ( LinkPtr  _parent,
LinkPtr  _child,
const ignition::math::Pose3d &  _pose 
)
inherited

Set pose, parent and child links of a physics::Joint.

Parameters
[in]_parentParent link.
[in]_childChild link.
[in]_posePose containing Joint Anchor offset from child link.

◆ LocalAxis()

ignition::math::Vector3d LocalAxis ( const unsigned int  _index) const
inherited

Get the axis of rotation.

Parameters
[in]_indexIndex of the axis to get.
Returns
Axis value for the provided index.

Referenced by Joint::ConnectJointUpdate().

◆ LowerLimit()

virtual double LowerLimit ( unsigned int  _index = 0) const
virtualinherited

Get the joint's lower limit.

For rotational axes, the value is in radians, for prismatic axes it is in meters.

Parameters
[in]_indexIndex of the axis, defaults to 0.
Returns
Lower limit of the axis.

Reimplemented in SimbodyJoint, DARTJoint, BulletBallJoint, BulletHinge2Joint, BulletUniversalJoint, BulletHingeJoint, ODEBallJoint, BulletSliderJoint, SimbodyBallJoint, and SimbodyScrewJoint.

Referenced by Joint::ConnectJointUpdate().

◆ operator==()

bool operator== ( const Base _ent) const
inherited

Returns true if the entities are the same.

Checks only the name.

Parameters
[in]_entBase object to compare with.
Returns
True if the entities are the same.

Referenced by Base::Update().

◆ ParentWorldPose()

ignition::math::Pose3d ParentWorldPose ( ) const
inherited

Get anchor pose on parent link relative to world frame.

When there is zero joint error, this should match the value returned by Joint::WorldPose() for the constrained degrees of freedom.

Returns
Anchor pose on parent link in world frame.

Referenced by Joint::ConnectJointUpdate().

◆ Position()

virtual double Position ( const unsigned int  _index = 0) const
finalvirtualinherited

Get the position of an axis according to its index.

For rotational axes, the value is in radians. For prismatic axes, it is in meters.

For static models, it returns the static joint position.

It returns ignition::math::NAN_D in case the position can't be obtained. For instance, if the index is invalid, if the joint is fixed, etc.

Subclasses can't override this method. See PositionImpl instead.

Parameters
[in]_indexIndex of the axis, defaults to 0.
Returns
Current position of the axis.
See also
PositionImpl

Referenced by Joint::ConnectJointUpdate().

◆ PositionImpl()

virtual double PositionImpl ( const unsigned int  _index) const
virtual

Helper function to get the position of an axis.

Subclasses must override this.

Parameters
[in]_indexIndex of the axis, defaults to 0.
Returns
Position of the axis.
See also
Position

Implements Joint.

◆ Print()

void Print ( const std::string &  _prefix)
inherited

Print this object to screen via gzmsg.

Parameters
[in]_prefixUsually a set of spaces.

Referenced by Base::Update().

◆ RegisterIntrospectionItems()

virtual void RegisterIntrospectionItems ( )
overrideprotectedvirtualinherited

Register items in the introspection service.

Reimplemented from Base.

Referenced by Joint::ConnectJointUpdate().

◆ RemoveChild() [1/3]

virtual void RemoveChild ( unsigned int  _id)
virtualinherited

Remove a child from this entity.

Parameters
[in]_idID of the child to remove.

Referenced by Link::GetKinematic(), and Base::Update().

◆ RemoveChild() [2/3]

void RemoveChild ( const std::string &  _name)
inherited

Remove a child by name.

Parameters
[in]_nameName of the child.

◆ RemoveChild() [3/3]

void RemoveChild ( physics::BasePtr  _child)
inherited

Remove a child by pointer.

Parameters
[in]_childPointer to the child.

◆ RemoveChildren()

void RemoveChildren ( )
inherited

Remove all children.

Referenced by Base::Update().

◆ Reset() [1/2]

virtual void Reset ( )
overridevirtualinherited

Reset the joint.

Reimplemented from Joint.

◆ Reset() [2/2]

virtual void Reset ( Base::EntityType  _resetType)
virtualinherited

Calls recursive Reset on one of the Base::EntityType's.

Parameters
[in]_resetTypeThe type of reset operation

◆ ResolveAxisXyz()

ignition::math::Vector3d ResolveAxisXyz ( const unsigned int  _index,
const std::string &  _resolveTo = "" 
) const
inherited

Resolve axis xyz value to the named frame, defaulting to the joint frame if no frame name is supplied.

Parameters
[in]_indexjoint axis index.
[in]_resolveToname of frame in which to resolve axis xyz. return Resolved axis vector.

Referenced by Joint::ConnectJointUpdate().

◆ SDFPoseRelativeToParent()

ignition::math::Pose3d SDFPoseRelativeToParent ( ) const
inherited

Get the SDF pose of the object according to the sdf 1.6 convention.

This convention is that the pose of an element is relative to its parent XML element, except for joints, whose pose is relative to the child link.

Returns
The pose of the object resolved according to the sdf 1.6 convention

Referenced by Base::Update().

◆ SDFSemanticPose()

virtual std::optional<sdf::SemanticPose> SDFSemanticPose ( ) const
overridevirtualinherited

Get the SDF SemanticPose object associated with the pose of this object.

Objects that support frame semantics need to override this function and provide this function.

Reimplemented from Base.

Referenced by Joint::ConnectJointUpdate().

◆ SetAnchor()

virtual void SetAnchor ( const unsigned int  _index,
const ignition::math::Vector3d &  _anchor 
)
virtual

Set the anchor point.

Parameters
[in]_indexIndex of the axis.
[in]_anchorAnchor value.

Implements Joint.

◆ SetAxis()

virtual void SetAxis ( const unsigned int  _index,
const ignition::math::Vector3d &  _axis 
)
virtual

Set the axis of rotation where axis is specified in local joint frame.

Parameters
[in]_indexIndex of the axis to set.
[in]_axisVector in local joint frame of axis direction (must have length greater than zero).

Reimplemented from ODEJoint.

◆ SetCFM()

void SetCFM ( double  _cfm)
inherited

Set the CFM of this joint.

Parameters
[in]_cfmThe Constraint Force Mixing value

◆ SetDamping()

virtual void SetDamping ( unsigned int  _index,
double  _damping 
)
overridevirtualinherited

Set the joint damping.

Parameters
[in]_indexIndex of the axis to set, currently ignored, to be implemented.
[in]_dampingDamping value for the axis.

Implements Joint.

◆ SetEffortLimit()

virtual void SetEffortLimit ( unsigned int  _index,
double  _effort 
)
virtualinherited

Set the effort limit on a joint axis.

Parameters
[in]_indexIndex of the axis to set.
[in]_effortEffort limit for the axis.

Referenced by Joint::ConnectJointUpdate().

◆ SetERP()

void SetERP ( double  _erp)
inherited

Set the ERP of this joint.

Parameters
[in]_erpError Reduction Parameter value.

◆ SetForce()

virtual void SetForce ( unsigned int  _index,
double  _effort 
)
overridevirtualinherited

Set the force applied to this physics::Joint.

Note that the unit of force should be consistent with the rest of the simulation scales. Force is additive (multiple calls to SetForce to the same joint in the same time step will accumulate forces on that Joint). Forces are truncated by effortLimit before applied.

Parameters
[in]_indexIndex of the axis.
[in]_effortForce value.

Implements Joint.

Referenced by ODEJoint::GetStopERP().

◆ SetForceImpl()

virtual void SetForceImpl ( unsigned int  _index,
double  _force 
)
protectedvirtual

Set the force applied to this physics::Joint.

Note that the unit of force should be consistent with the rest of the simulation scales. Force is additive (multiple calls to SetForceImpl to the same joint in the same time step will accumulate forces on that Joint).

Parameters
[in]_indexIndex of the axis.
[in]_forceForce value.

Implements ODEJoint.

◆ SetLowerLimit()

virtual void SetLowerLimit ( const unsigned int  _index,
const double  _limit 
)
overridevirtualinherited

Set the joint's lower limit.

For rotational axes, the value is in radians. For prismatic axes, it is in meters.

Parameters
[in]_indexIndex of the axis.
[in]_limitLower limit of the axis.

Reimplemented from Joint.

Reimplemented in ODEBallJoint, and ODEUniversalJoint.

Referenced by ODEJoint::GetStopERP().

◆ SetModel()

void SetModel ( ModelPtr  _model)
inherited

Set the model this joint belongs too.

Parameters
[in]_modelPointer to a model.

◆ SetName()

virtual void SetName ( const std::string &  _name)
virtualinherited

Set the name of the entity.

Parameters
[in]_nameNew name.

Reimplemented in Entity, and DARTJoint.

Referenced by Base::Update().

◆ SetParam() [1/2]

virtual void SetParam ( unsigned int  _parameter,
double  _value 
)
virtual

Set an ODE joint paramter.

By default this does nothing. It should be overridden in child classes where appropriate

Parameters
[in]_parameterID of the parameter to set.
[in]_valueValue to set.

Reimplemented from ODEJoint.

◆ SetParam() [2/2]

virtual bool SetParam ( const std::string &  _key,
unsigned int  _index,
const boost::any &  _value 
)
overridevirtualinherited

Set a non-generic parameter for the joint.

replaces SetAttribute(Attribute, int, double) List of parameters: "friction" Axis Coulomb joint friction coefficient. "hi_stop" Axis upper limit. "lo_stop" Axis lower limit.

Parameters
[in]_keyString key.
[in]_indexIndex of the axis.
[in]_valueValue of the attribute.

Implements Joint.

Reimplemented in ODEGearboxJoint, ODEScrewJoint, and ODEUniversalJoint.

◆ SetParent()

void SetParent ( BasePtr  _parent)
inherited

Set the parent.

Parameters
[in]_parentParent object.

Referenced by Base::Update().

◆ SetPosition()

virtual bool SetPosition ( const unsigned int  _index,
const double  _position,
const bool  _preserveWorldVelocity = false 
)
overridevirtualinherited

The child links of this joint are updated based on desired position.

And all the links connected to the child link of this joint except through the parent link of this joint moves with the child link.

Parameters
[in]_indexIndex of the joint axis (degree of freedom).
[in]_positionPosition to set the joint to. unspecified, pure kinematic teleportation.
[in]_preserveWorldVelocityIf true, the velocity of the child link with respect to the world frame will remain the same after setting the position. By default this is false, which means there are no guarantees about what the child link's world velocity will be after the position is changed (the behavior is determined by the underlying physics engine).
Note
{Only ODE and Bullet support _preserveWorldVelocity being true.}
Returns
returns true if operation succeeds, false if it fails.

Reimplemented from Joint.

◆ SetPositionMaximal()

bool SetPositionMaximal ( const unsigned int  _index,
double  _position,
const bool  _preserveWorldVelocity = false 
)
protectedinherited

Helper function for maximal coordinate solver SetPosition.

The child links of this joint are updated based on position change. And all the links connected to the child link of this joint except through the parent link of this joint moves with the child link.

Parameters
[in]_indexIndex of the joint axis (degree of freedom).
[in]_positionPosition to set the joint to.
[in]_preserveWorldVelocityTrue if to preserve the world velocity before set position, default is false.
Returns
returns true if operation succeeds, false if it fails.

Referenced by Joint::ConnectJointUpdate().

◆ SetProvideFeedback()

virtual void SetProvideFeedback ( bool  _enable)
overridevirtualinherited

Set whether the joint should generate feedback.

Parameters
[in]_enableTrue to enable joint feedback.

Reimplemented from Joint.

Referenced by ODEJoint::GetStopERP().

◆ SetSaveable()

void SetSaveable ( bool  _v)
inherited

Set whether the object should be "saved", when the user selects to save the world to xml.

Parameters
[in]_vSet to True if the object should be saved.

Referenced by Base::Update().

◆ SetSelected()

virtual bool SetSelected ( bool  _show)
virtualinherited

Set whether this entity has been selected by the user through the gui.

Parameters
[in]_showTrue to set this entity as selected.

Reimplemented in Link.

Referenced by Base::Update().

◆ SetState()

void SetState ( const JointState _state)
inherited

Set the joint state.

Parameters
[in]_stateJoint state

◆ SetStiffness()

virtual void SetStiffness ( unsigned int  _index,
const double  _stiffness 
)
overridevirtualinherited

Set the joint spring stiffness.

Parameters
[in]_indexIndex of the axis to set, currently ignored, to be implemented.
[in]_stiffnessSpring stiffness value for the axis. : rename to SetSpringStiffness()

Implements Joint.

◆ SetStiffnessDamping()

virtual void SetStiffnessDamping ( unsigned int  _index,
double  _stiffness,
double  _damping,
double  _reference = 0 
)
overridevirtualinherited

Set the joint spring stiffness.

Parameters
[in]_indexIndex of the axis to set, currently ignored, to be implemented.
[in]_stiffnessStiffness value for the axis.
[in]_referenceSpring zero load reference position. : rename to SetSpringStiffnessDamping()

Implements Joint.

◆ SetStopDissipation()

void SetStopDissipation ( unsigned int  _index,
double  _dissipation 
)
inherited

Set joint stop dissipation.

Parameters
[in]_indexjoint axis index.
[in]_dissipationjoint stop dissipation coefficient.

Referenced by Joint::ConnectJointUpdate().

◆ SetStopStiffness()

void SetStopStiffness ( unsigned int  _index,
double  _stiffness 
)
inherited

Set joint stop stiffness.

Parameters
[in]_indexjoint axis index.
[in]_stiffnessjoint stop stiffness coefficient.

Referenced by Joint::ConnectJointUpdate().

◆ SetUpperLimit()

virtual void SetUpperLimit ( const unsigned int  _index,
const double  _limit 
)
overridevirtualinherited

Set the joint's upper limit.

For rotational axes, the value is in radians. For prismatic axes, it is in meters.

Parameters
[in]_indexIndex of the axis.
[in]_limitUpper limit of the axis.

Reimplemented from Joint.

Reimplemented in ODEBallJoint, and ODEUniversalJoint.

Referenced by ODEJoint::GetStopERP().

◆ SetVelocity()

virtual void SetVelocity ( unsigned int  _index,
double  _vel 
)
virtual

Set the velocity of an axis(index).

In ODE and Bullet, the SetVelocityMaximal function is used to set the velocity of the child link relative to the parent. In Simbody and DART, this function updates the velocity state, which has a recursive effect on the rest of the chain.

Parameters
[in]_indexIndex of the axis.
[in]_velVelocity.

Implements Joint.

◆ SetVelocityLimit()

virtual void SetVelocityLimit ( unsigned int  _index,
double  _velocity 
)
virtualinherited

Set the velocity limit on a joint axis.

Parameters
[in]_indexIndex of the axis to set.
[in]_velocityVelocity limit for the axis.

Referenced by Joint::ConnectJointUpdate().

◆ SetVelocityMaximal()

bool SetVelocityMaximal ( unsigned int  _index,
double  _velocity 
)
protectedinherited

Helper function for maximal coordinate solver SetVelocity.

The velocity of the child link of this joint is updated relative to the current parent velocity. It currently does not act recursively.

Parameters
[in]_indexIndex of the joint axis (degree of freedom).
[in]_velocityVelocity to set at this joint.
Returns
returns true if operation succeeds, false if it fails.

Referenced by Joint::ConnectJointUpdate().

◆ SetWorld()

void SetWorld ( const WorldPtr _newWorld)
inherited

Set the world this object belongs to.

This will also set the world for all children.

Parameters
[in]_newWorldThe new World this object is part of.

Referenced by Base::Update().

◆ TypeStr()

std::string TypeStr ( ) const
inherited

Get the string name for the entity type.

Returns
The string name for this entity.

Referenced by Base::Update().

◆ UnregisterIntrospectionItems()

virtual void UnregisterIntrospectionItems ( )
protectedvirtualinherited

Unregister items in the introspection service.

Referenced by Base::Update().

◆ Update()

void Update ( )
overridevirtualinherited

Update the joint.

Reimplemented from Base.

◆ UpdateParameters()

virtual void UpdateParameters ( sdf::ElementPtr  _sdf)
overridevirtualinherited

Update the parameters using new sdf values.

Parameters
[in]_sdfSDF values to update from.

Reimplemented from Base.

◆ UpperLimit()

virtual double UpperLimit ( const unsigned int  _index = 0) const
virtualinherited

Get the joint's upper limit.

For rotational axes, the value is in radians. For prismatic axes, it is in meters.

It returns ignition::math::NAN_D in case the limit can't be obtained. For instance, if the index is invalid, if the joint is fixed, etc.

Parameters
[in]_indexIndex of the axis, defaults to 0.
Returns
Lower limit of the axis.

Reimplemented in SimbodyJoint, DARTJoint, BulletBallJoint, BulletHinge2Joint, BulletUniversalJoint, BulletHingeJoint, ODEBallJoint, BulletSliderJoint, SimbodyBallJoint, and SimbodyScrewJoint.

Referenced by Joint::ConnectJointUpdate().

◆ URI()

common::URI URI ( ) const
inherited

Return the common::URI of this entity.

The URI includes the world where the entity is contained and all the hierarchy of sub-entities that can compose this entity. E.g.: A link entity contains the name of the link and the model where the link is contained.

Returns
The URI of this entity.

Referenced by Base::Update().

◆ UseImplicitSpringDamper()

void UseImplicitSpringDamper ( const bool  _implicit)
inherited

Set flag indicating whether implicit spring damper is enabled.

Parameters
[in]_implicitTrue if implicit spring damper is used.

◆ UsesImplicitSpringDamper()

bool UsesImplicitSpringDamper ( )
inherited

Get flag indicating whether implicit spring damper is enabled.

Returns
True if implicit spring damper is used.

◆ WorldPose()

ignition::math::Pose3d WorldPose ( ) const
inherited

Get pose of joint frame relative to world frame.

Note that the joint frame is defined with a fixed offset from the child link frame.

Returns
Pose of joint frame relative to world frame.

Referenced by Joint::ConnectJointUpdate().

Member Data Documentation

◆ anchorLink

LinkPtr anchorLink
protectedinherited

Anchor link.

◆ anchorPos

ignition::math::Vector3d anchorPos
protectedinherited

Anchor pose.

This is the xyz position of the joint frame specified in the world frame.

◆ anchorPose

ignition::math::Pose3d anchorPose
protectedinherited

Anchor pose specified in SDF <joint><pose> tag.

AnchorPose is the transform from child link frame to joint frame specified in the child link frame. AnchorPos is more relevant in normal usage, but sometimes, we do need this (e.g. GetForceTorque and joint visualization).

◆ angleOffset

double angleOffset[MAX_JOINT_AXIS]
protectedinherited

Joint angle(s) when ODE joint has angle 0.

◆ applyDamping

gazebo::event::ConnectionPtr applyDamping
protectedinherited

apply damping for adding viscous damping forces on updates

◆ axisExpressedIn

std::string axisExpressedIn[2]
protectedinherited

Expressed-in values for each axis that are checked if the DOM has errors.

◆ childLink

LinkPtr childLink
protectedinherited

The first link this joint connects to.

◆ children

Base_V children
protectedinherited

Children of this entity.

◆ dissipationCoefficient

double dissipationCoefficient[2]
protectedinherited

joint viscous damping coefficient

◆ effortLimit

double effortLimit[2]
protectedinherited

Store Joint effort limit as specified in SDF.

◆ introspectionItems

std::vector<common::URI> introspectionItems
protectedinherited

All the introspection items regsitered for this.

◆ jointId

dJointID jointId
protectedinherited

This is our ODE ID.

◆ lowerLimit

double lowerLimit[2]
protectedinherited

Store Joint position lower limit as specified in SDF.

◆ model

ModelPtr model
protectedinherited

Pointer to the parent model.

◆ parent

BasePtr parent
protectedinherited

Parent of this entity.

◆ parentAnchorPose

ignition::math::Pose3d parentAnchorPose
protectedinherited

Anchor pose relative to parent link frame.

◆ parentLink

LinkPtr parentLink
protectedinherited

The second link this joint connects to.

◆ provideFeedback

bool provideFeedback
protectedinherited

Provide Feedback data for contact forces.

◆ sdf

sdf::ElementPtr sdf
protectedinherited

The SDF values for this object.

◆ springReferencePosition

double springReferencePosition[2]
protectedinherited

joint spring reference (zero load) position

◆ stiffnessCoefficient

double stiffnessCoefficient[2]
protectedinherited

joint stiffnessCoefficient

◆ upperLimit

double upperLimit[2]
protectedinherited

Store Joint position upper limit as specified in SDF.

◆ velocityLimit

double velocityLimit[2]
protectedinherited

Store Joint velocity limit as specified in SDF.

◆ world

WorldPtr world
protectedinherited

Pointer to the world.

◆ wrench

JointWrench wrench
protectedinherited

Cache Joint force torque values in case physics engine clears them at the end of update step.


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