A brief overview about urdf files, xacro files etc aimed at exploring the robot description.
- Pkgs for robot modelling
- Generalitites about Robot modelling using URDF
- Create a pkg for the robot description
- Generalities about xacro files
- Creating a robot description for a seven DOF robot manipulator
- Working with the joint_state_publisher and robot_state_publisher for
- Creating the robot description for a differential wheeled robot
- Creating the robot description for the explab_2nd
- Using the ROS MoveIt! and navigation stack for the assignment
ROS uses a standard metapackage for designing and creating models named robot_model
.
It basically consists in a set of packages whose purpose is to provide support for the 3D model description reflecting the same features of the real hardware. Those packages are:
urdf
- it contains a C++ parser for the Unified Robot Description Format which stands for an XML file representing a general robot modelkdl_parser
- It stands for Kinematic and Dynamics Library (KDL). It contains parsers tools needed for creating a kinematic tree. This is used to:- publish the joint states
- forward and inverse the kinematic of the robot
joint_state_publisher
- It contains a node responsible for:- reading the robot model description
- finding its joints
- publishing joints' values by means of sliders
robot_state_publisher
- It reads the current robot joint states and publishes the 3D poses of each robot link using the kinematics treecollada_urdf
As mentioned in the previoius section the URDF parsers are critical for parsing a robot model with some sensors and a working environment
Only robot with links arranged in tree structure can be described through URDF. Hence, the robot must have:
- rigid links (flexible ones are not allowed)
- each link is connected with others by means of joints
The URDF basically consists in a bunch of XML tags, and it represents the kinematic and dynamic description of the robot, its visual represetntation and its collision model
XML Macros (aka Xacro) show some add-ons to improve readbility and for building complex robot's descriptions. The Xacro allows to create macros inside the robot description quite useful.
โ ๏ธ xacro files should always be converted in URDF for being employable
use this extension for xacro files, as the first declaration of the file ("name" stands for the name of the robot)
<?xml version="1.0"?>
<robot xmlns:xacro="http://www.ros.org/wiki/xacro" name="โฆ">
we can define properties, as for constants (to avoid hardcoding), i.e.:
<xacro:property name="cluedo_link_length" value="0.4" />
<xacro:property name="cluedo_link_radius" value="0.3" />
So that in the urdf file, we can simply refer to the link's lenght through its name, i.e. in the following โฆ
<cylinder length="${cluedo_link_length}" radius="${cluedo_link_radius}"/>
we can also define math expressions using basic operations, i.e.
<cylinder length="${cluedo_link_length+2}" radius="${cluedo_link_radius}"/>
<cylinder length="${cluedo_link_length/3}" radius="${cluedo_link_radius}"/>
<cylinder length="${cluedo_link_length-0.4}" radius="${cluedo_link_radius}"/>
or we can define macros for describing an i.e. an inertial matrix, where the only value that actually changes is its mass, taken as parameter
<xacro:macro name="my_inertial_matrix" params="mass">
<inertial>
<mass value="${mass}" />
<inertia ixx="0.3" ixy="0.0" ixz="0.0" iyy="0.2" iyz="0.0" izz="0.5" />
</inertial>
</xacro:macro>
To manually convert the xacro file into urdf, please run
rosrun xacro xacro simple_robot.xacro --inorder > simple_robot_generated.urdf
Otherwise, to include such conversion inside a launch file, add these two lines:
<param name="robot_description" command="$(find xacro)/xacro --inorder $(find robot_modelling)/urdf/simple_robot.xacro"/>
Being robot_modelling
the name of the package
For cheking the model:
-
save the current model with
.urdf
extension -
check if the current model contains errors (by parsing the urdf tag and show the potentially occuring error)
check_urdf simple_robot.urdf
-
for viewing the structure of the robot links and joints graphically (two files will be generated with both
.gv
and.pdf
extensions)urdf_to_graphiz simple_robot.urdf
-
For inspecting the model:
evince simple_robot.pdf
<<<<<<< HEAD
For ending up with a ".urdf" version of our .xacro file, simply run:
rosrun xacro xacro ???.xacro --inorder > ???.urdf
where ???
simply stands for the name of the file
For checking the model, and launch the simulation:
-
enable "execution" permission
chmod +x test.py
-
run the script
./test.py
For taking a look at the robot structure by means of RVIZ, please run:
roslaunch pkgName demo.launch
For further information about tags click here for the official documentation reference
โช๏ธ Also, remember to substitute values whenever โฆ
occurs!
robot def:
<?xml version="1.0"?>
<robot name="<name of the robot>"
<link> โฆ </link>
<link> โฆ </link>
<joint> โฆ </joint>
<joint> โฆ </joint>
</robot>
gazebo plugins inclusion:
<gazebo reference="link_ex">
<material>Gazebo/Black</material>
</gazebo>
Link definition
Please note that collision and inertia parameters are needed, for allowing Gazebo to properly simulate the robot model itsef
<link name="<name of the link>">
<inertial>
<mass value ="โฆ">
<inertia ixx="โฆ" ixy="โฆ" ixz="โฆ" iyy="โฆ" iyz="โฆ" izz="โฆ"/>
</inertial>
<visual>
<geometry>
< โฆ length="โฆ" radius="โฆ"/>
</geometry>
<origin rpy="โฆ โฆ โฆ" xyz="โฆ โฆ โฆ"/>
</visual>
<collision>
<geometry>
<cylinder length="โฆ" radius="โฆ"/>
</geometry>
<origin rpy="โฆ" xyz="โฆ"/>
</collision>
</link>
Please note the choice of the link's geometry is up to you!
About the geometry tag ... โฌ๏ธ
There are three shapes of geometries to choose between:-
The box shape
<geometry> <box size="0.4 0.2 0.08" /> </geometry>
-
The cylinder shape
<geometry> <cylinder length="0.05" radius="0.2" /> </geometry>
-
The sphere shape
<geometry> <sphere radius="0.08" /> </geometry>
Joint definition
Please note that the effort is intended as the maximum force supported by the joint; Moreover, we refer to revolute type joint with radians and to prysmatic type with meters
<joint name="<name of the joint>">
<parent link="โฆ"/>
<child link="โฆ"/>
<origin xyz="โฆ โฆ โฆ"/>
<axis xyz="โฆ โฆ โฆ" />
<calibration โฆ />
<dynamics damping โฆ />
<limit effort โฆ />
</joint>
๐ Find here a Gazebo color palette with xckd color names, by @naoki_mizuno
Please, note that some .xacro
files have been taken from the Mastering ROS for robotics programming book, published by Packt. All rights reserved
.
โโโ CMakeLists.txt
โโโ README.md
โโโ launch
โย ย โโโ model_viewer.launch
โย ย โโโ model_viewer_arm.launch
โย ย โโโ model_viewer_cluedo.launch
โย ย โโโ model_viewer_mobile.launch
โโโ meshes
โย ย โโโ sensors
โย ย โโโ xtion_pro_live
โย ย โโโ xtion_pro_live.dae
โย ย โโโ xtion_pro_live.png
โโโ moveit_fixer.py
โโโ package.xml
โโโ test.py
โโโ test_arm.py
โโโ test_cluedo.py
โโโ test_mobile.py
โโโ urdf
โโโ differential_wheeled_base.gv
โโโ differential_wheeled_base.pdf
โโโ differential_wheeled_base.urdf
โโโ differential_wheeled_base.xacro
โโโ differential_wheeled_robot.gv
โโโ differential_wheeled_robot.pdf
โโโ manipulator_arm.gv
โโโ manipulator_arm.pdf
โโโ manipulator_arm.urdf
โโโ manipulator_arm.xacro
โโโ mobile_and_arm.gv
โโโ mobile_and_arm.pdf
โโโ mobile_and_arm.urdf
โโโ mobile_and_arm.xacro
โโโ sensors
โย ย โโโ xtion_pro_live.gazebo.xacro
โย ย โโโ xtion_pro_live.urdf.xacro
โโโ simple_robot.gv
โโโ simple_robot.pdf
โโโ simple_robot.urdf
โโโ wheels.urdf.xacro
6 directories, 34 files
My ultimate model, basically consists in a seven degrees of freedom robotic's manipulator, installed upon a differential wheeled platform, capable of carrying the entire structure within the simulated environment. Moreover, a XTION PRO LIVE motion sensor (rgbd camera) is mounted.
By simply running:
chmod +x test_cluedo.py
./test_cluedo.py
The .xacro
file will be converted into urdf. Then, the robot's tree hierarchy will be checked and prompted (by means of a pdf file, as shown in the picture)
Once the pdf file gets closed, the launch file model_viewer_cluedo.launch
is triggered and the robot is shown through Rviz
Please note that any implementation of the moveit configuration has been made through a specific version (1.15) of the framework itself. This is the same employed for the Experimental Robotics Laboratory course and it is employed within the package explab_2nd
apt-get ...
for downloading MoveIt, please run the script moveit_fixer.py
, where all the instructions needed for obtaining the 1.15 moveit framework, have been provided (thanks to Professor Recchiuto )
chmod +x moveit_fixer.py
./moveit_fixer.py