This tool converts URDF files into Webots PROTO files or into Webots Robot node strings. Python 3.5 or higher is required.
On macOS, export the pip binary path to the PATH: export PATH="/Users/$USER/Library/Python/3.7/bin:$PATH"
git clone --recurse-submodules https://github.com/cyberbotics/urdf2webots.git
pip install --upgrade --editable urdf2webots
python -m urdf2webots.importer --input=someRobot.urdf [--output=outputFile] [--normal] [--box-collision] [--tool-slot=linkName] [--help]
The script accepts the following arguments:
--init-pos="[1.2, 0.5, -1.5]"
would set the first 3 joints of your robot to the specified values, and leave the rest with their default value.filename="head.obj"
with --relative-path-prefix="/home/user/myRobot/"
will become filename="/home/user/myRobot/head.obj"
.In case the --input option is missing, the script will read the URDF content from stdin
. In that case, you can pipe the content of your URDF file into the script: cat my_robot.urdf | urdf2proto.py
. Relative paths present in your URDF file will be treated relatively to the current directory from which the script is called unless --relative-path-prefix is set.
Previously the --static-base argument was supported in order to set the base link to be static (disabled physics). It has been removed as there is a better way to do it by adding the following to your URDF file (assuming base_link is the root link of your robot):
<link name="world" /> <joint name="world_joint" type="fixed"> <parent link="world" /> <child link="base_link" /> </joint>
The command line arguments available from the terminal are also available from the Python interface, but some have different names:
Terminal Python --input input --output output --robot-name robotName --normal normal --box-collision boxCollision --tool-slot toolSlot --translation initTranslation --rotation initRotation --init-pos initPos --link-to-def linkToDef --joint-to-def jointToDef --relative-path-prefix relativePathPrefixIn Python, you can convert a URDF file by passing its path as an argument to the convertUrdfFile()
function or directly by passing its content as an argument to the convertUrdfContent()
function.
from urdf2webots.importer import convertUrdfFile
convertUrdfFile(input = 'MY_PATH/MY_URDF.urdf')
or
import pathlib
from urdf2webots.importer import convertUrdfContent
robot_description = pathlib.Path('MY_PATH/MY_URDF.urdf').read_text()
convertUrdfContent(input = robot_description)
Convert into Webots Robot node strings
from urdf2webots.importer import convertUrdfFile
convertUrdfFile(input = 'MY_PATH/MY_URDF.urdf', robotName="myRobot")
or
import pathlib
from urdf2webots.importer import convertUrdfContent
robot_description = pathlib.Path('MY_PATH/MY_URDF.urdf').read_text()
convertUrdfContent(input = robot_description, robotName="myRobot")
Check out this tutorial for a more in-depth, step by step instruction, on how to:
This tool was tested using Webots R2022b on Ubuntu22.04. You can find the sources of these URDF files here:
Supported by ROSIN - ROS-Industrial Quality-Assured Robot Software Components. More information: rosin-project.eu
This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement no. 732287.
Supported by OpenDR - Open Deep Learning Toolkit for Robotics. More information: opendr.eu
This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement no. 871449.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4