[Documentation] [TitleIndex] [WordIndex

XML Robot Description Format (URDF)

The Unified Robot Description Format (URDF) is an XML specification to describe a robot. We attempt to keep this specification as general as possible, but obviously the specification cannot describe all robots. The main limitation at this point is that only tree structures can be represented, ruling out all parallel robots. Also, the specification assumes the robot consists of rigid links connected by joints; flexible elements are not supported. The specification covers:


The description of a robot consists of a set of link elements, and a set of joint elements connecting the links together. So a typical robot description looks something like this:

   1 <?xml version="1.0"?>
   2 <?xml-model href="https://raw.githubusercontent.com/ros/urdfdom/master/xsd/urdf.xsd" ?>
   3 <robot name="pr2" xmlns="http://www.ros.org">
   4   <link> ... </link>
   5   <link> ... </link>
   6   <link> ... </link>
   8   <joint>  ....  </joint>
   9   <joint>  ....  </joint>
  10   <joint>  ....  </joint>
  11 </robot>

You can see that the root element of the URDF format is a <robot> element.

<link> element

For details on the link description format, check out the link elements page.

<joint> element

For details on the joint description format, check out the joint elements page.

2024-07-13 14:39