ros2+gazebo+urdf:ros2机器人使用gazebo的urdf文件中的＜gazebo＞部分官网资料
原文链接SDFormat extensions to URDF (the 'gazebo' tag) — Documentation
注意了ros2的gazebo部分已经跟ros1的gazebo部分不一样了：
Toggle navigation
- Specification
- API
- Documentation
- Download
Back
Edit Version: 1.6
Table of Contents
- SDFormat extensions to URDF (the
tag) Elements For Elements For Links - Special meaning for
, , and Elements For Joints - Fixed joint lumping
SDFormat extensions to URDF (the
When URDF files are loaded by Gazebo (both Gazebo-classic and the new Gazebo), the URDF content is first converted to SDFormat before being processed by Gazebo. Users who want to modify the resulting SDFormat output to include SDFormat specific elements may do so using the
The URDF to SDFormat conversion usually happens automatically without users observing the resulting SDFormat file. To diagnose any issues that might come up during the conversion, the tool
gz sdf -p
can be used to convert the URDF file to SDFormat that can be inspected by the user.
The following is the documentation of the various tags available under
reference attribute applies to the SDFormat
urdf文件内不带reference属性的
Example:
true
results in:
true
标签
When using the reference attribute. （gazebo标签内的reference属性需要填写joint名称例如laser或camera或base等）There are a number of special tags that modify the values of elements or attributes in the generated SDFormat file. Any tag that is not listed in the table below will be directly inserted into the corresponding element in the SDFormat output. This direct insertion is sometimes referred to as blob insertion.所有不在下表中列出的标签例如
Table of elements with special meaning:
| Name | Type | Description | Corresponding SDFormat element |
|---|---|---|---|
| turnGravityOff | bool | A value of "true" turns gravity off. Alternatively, gravity (with opposite boolean value) can be used via blob insertion |
gravity |
| dampingFactor | double | Exponential velocity decay of the link velocity - takes the value and multiplies the previous link velocity by (1-dampingFactor). | velocity_decay/linear and velocity_decay/angular |
| maxVel | double | Maximum contact correction velocity truncation term. (See the Gazebo-classic tutorial on Constraints Parameters for more detail) | collision/surface/contact/ode/max_vel |
| minDepth | double | Minimum allowable depth before contact correction impulse is applied. (See the Gazebo-classic tutorial on Constraints Parameters for more detail) | collision/surface/contact/ode/min_depth |
| mu1 | double | Friction coefficients μ for the principal contact directions along the contact surface as defined by the Open Dynamics Engine (ODE) (see parameter descriptions in ODE's user guide and the Gazebo-classic tutorial on Friction Parameters for more detail) | collision/surface/friction/ode/mu |
| mu2 | collision/surface/friction/ode/mu2 |
||
| fdir1 | vector | 3-tuple specifying direction of mu1 in the collision local reference frame. (See the Gazebo-classic tutorial on Friction Parameters for more detail) | collision/surface/friction/ode/fdir1 |
| kp | double | Contact stiffness k_p and damping k_d for rigid body contacts as defined by ODE (ODE uses erp and cfm but there is a mapping between erp/cfm and stiffness/damping. Also see See the Gazebo-classic tutorial on Contact Parameters for more detail) | collision/surface/contact/ode/kp |
| kd | collision/surface/contact/ode/kd |
||
| selfCollide | bool | If true, the link can collide with other links in the model. | self_collide |
| maxContacts | int | Maximum number of contacts allowed between two entities. This value overrides the max_contacts element defined in physics.(See the Gazebo-classic tutorial on Contact Parameters for more detail) | collision/max_contacts |
| laserRetro | double | Intensity value returned by laser sensor. | collision/laser_retro |
| visual | element | The content of the element will be inserted into each visual of the SDFormat link |
visual |
| material | element | The content of the element will be inserted into each material of the SDFormat link |
visual/material |
| collision | element | The content of the element will be inserted into each collision of the SDFormat link |
collision |
Note: The XPath used in the "Corresponding SDFormat element" column is relative to the link element.
Example:
The following shows how to set the first coefficient of friction for all
0.25
This creates the element //surface/friction/ode/mu in the collision element of the referenced link.
0 0 0 0 0 0
0.12
0.01
0
0
0.01
0
0.01
0 0 0 0 0 0
2
0.25
0 0 0 0 0 0
2
1
0.25
Special meaning for
The
Example:
Given the following URDF file with two visuals, the base_link.
0.25
Converts to the following SDFormat
0 0 0 0 0 0
0.12
0.01
0
0
0.01
0
0.01
0 0 0 0 0 0
2
0.25
2 0 0 0 0 0
1
2
0.25
The //gazebo/material, accepts a string value of the name of a material defined in a Gazebo-classic's material script. Examples include colors like Gazebo/SkyBlue as well as textures such as Gazebo/WoodFloor. The
Example:
Gazebo/Orange
results in:
0 0 0 0 0 0
0.10000000000000001
0.01
0
0
0.01
0
0.01
0 0 0 0 0 0
2
This tag is only relevant when using Gazebo-classic as the new version of Gazebo does not use material scripts. However, it is still possible to change the appearance of visuals that is compatible with the new Gazebo and this is by using the //gazebo/visual/material tag. Note the difference from the previous tag as the
Example:
0 0 1 1
results in:
0 0 0 0 0 0
0.12
0.01
0
0
0.01
0
0.01
0 0 0 0 0 0
2
0 0 1 1
where the base_link.
Warning: At the time of writing, there is a bug in the URDF to SDFormat converter that behaves incorrectly when
andtags in the URDF file have names.
When using the reference attribute. There are a number of special tags that modify the values of elements or attributes in the generated SDFormat file. Any tag that is not listed in the table below will be directly inserted into the corresponding
Table of elements with special meaning:
| Name | Type | Description | Corresponding SDFormat element |
|---|---|---|---|
| stopCfm | double | Joint stop constraint force mixing (cfm) and error reduction parameter (erp) used by ODE | physics/ode/limit/cfm |
| stopErp | physics/ode/limit/erp |
||
| provideFeedback | bool | Allows joints to publish their wrench data (force-torque) via a Gazebo plugin | physics/provide_feedback and physics/ode/provide_feedback |
| implicitSpringDamper | bool | If this flag is set to true, ODE will use ERP and CFM to simulate damping. This is a more stable numerical method for damping than the default damping tag. The cfmDamping element is deprecated and should be changed to implicitSpringDamper. | physics/ode/implicit_spring_damper |
| springStiffness | double | Spring stiffness in N/m. | axis/dynamics/spring_stiffness |
| springReference | double | Equilibrium position for the spring. | axis/dynamics/spring_reference |
| fudgeFactor | double | Scale the excess for in a joint motor at joint limits. Should be between zero and one. | physics/ode/fudge_factor |
| preserveFixedJoint | bool | By default, fixed joints in the URDF are "lumped", meaning that the contents of the child link are merged with the parent link with appropriate pose offsets and the joint is discarded. Setting this to true preserves the fixed joint and effectively disables fixed joint lumping. |
|
| disableFixedJointLumping | bool | By default, fixed joints in the URDF are "lumped", meaning that the contents of the child link are merged with the parent link with appropriate pose offsets and the joint is discarded. Setting this to true disables fixed joint lumping. This has a similar effect as preserveFixedJoint but, for backward compatibility reasons, replaces the fixed joint with a revolute joint with position limits set to 0. Users are encouraged to use preserveFixedJoint instead. |
Note: The XPath used in the "Corresponding SDFormat element" column is relative to the joint element.
Example: The spring reference and stiffness of a joint can be set using
0.5
0.25
This creates the elements //axis/dynamics/spring_reference and //axis/dynamics//spring_stiffness in the referenced joint of the SDFormat output.
0 0 0 0 0 0
0.12
0.01
0
0
0.01
0
0.01
0 0 1 0 0 0
base_link
end_effector
1 0 0
-10000000000000000
10000000000000000
0.5
0.25
0
0.20000000000000001
0 0 0 0 0 0
0 0 0 0 0 0
0.12
0.01
0
0
0.01
0
0.01
Fixed joint lumping
Fixed joint lumping (aka joint reduction), in the URDF to SDFormat conversion is the process of taking the child link of a fixed joint and merging all of its contents into the parent link. It is an optimization that benefits maximal coordinate physics engines by reducing the number of constraints needed to simulate the model. The process preserves the total mass of the two links and computes the center of mass and moment of inertia of the resultant link. All visual and collision elements present in the child link are moved to the parent link with appropriate pose offsets. The fixed joint itself is discarded and does not appear in the SDFormat output. As of libsdformat 9.9.0 frame elements that represent the discarded joint and child link are generated to preserve their pose information.
Fixed joint lumping is enabled by default, but can be disabled by setting preserveFixedJoint or disableFixedJointLumping to true. The two parameters behave similarly, but the preserveFixedJoint=true configuration results in a joint with a fixed type whereas the disableFixedJointLumping=true configuration results in a revolute joint with position limits set to 0. Note that when both preserveFixedJoint=true and disableFixedJointLumping=true are set on a joint, the preserveFixedJoint setting will take precedence and the resulting joint will have a fixed type. Fixed joint lumping can also be disabled for all joints if ParserConfig::URDFPreserveFixedJoint is true.
Warning: Disabling joint lumping should only be done when both parent and child links have positive mass and corresponding
elements.
Example: The following URDF demonstrates fixed joint lumping where the resulting SDFormat output only has one link
results in:
0 0 0.5 0 0 0
0.5
0.14499999999999999
0
0
0.14499999999999999
0
0.02
0 0 0 0 0 0
2
2 0 1 0 0 0
1
2
0 0 1 0 -0 0
Note that the mass of base_link is the sum of the masses of the original base_link and end_effector links. The visual element of end_effector has been merged into base_link with a pose value that takes into account the pose of the original end_effector link and joint j1 as well as the pose of the original visual.
Example: The same example above is repeated, but fixed joints preserved (preserveFixedJoint=true).
true
results in:
0 0 0 0 0 0
0.25
0.01
0
0
0.01
0
0.01
0 0 0 0 0 0
2
0 0 1 0 0 0
base_link
end_effector
0
0
0 0 1
-10000000000000000
10000000000000000
0
0.20000000000000001
0 0 0 0 0 0
0 0 0 0 0 0
0.25
0.01
0
0
0.01
0
0.01
2 0 0 0 0 0
1
2
Here, the link end_effector is still present in the SDFormat output with mass and inertia equal to the URDF end_effector link. The visual of end_effector is also still present in the end_effector link of the SDFormat output. The joint j1 is also still present and its type is fixed.
Example: The same example above is repeated, but with fixed joint lumping disabled (disableFixedJointLumping=true).
true
results in:
0 0 0 0 0 0
0.25
0.01
0
0
0.01
0
0.01
0 0 0 0 0 0
2
0 0 1 0 0 0
base_link
end_effector
0
0
0
0
0
0
0 0 1
0
0.20000000000000001
0 0 0 0 0 0
0 0 0 0 0 0
0.25
0.01
0
0
0.01
0
0.01
2 0 0 0 0 0
1
2
The output is the same as preserveFixedJoint=true example, execept that joint j1 has a revolute type.
©2020 Open Source Robotics Foundation
SDFormat is open-source licensed under
Apache 2.0