urdf2webots 1.0.7

A converter between URDF and PROTO files.

urdf2webots

This tool converts URDF files into Webots PROTO files.

Install

From pip

pip install urdf2webots

On macOS, export the pip binary path to the PATH: export PATH="/Users/$USER/Library/Python/3.7/bin:$PATH"

From Sources

git clone https://github.com/cyberbotics/urdf2webots.git
cd urdf2webots
pip install -r requirements.txt

Usage

From pip

python -m urdf2webots.importer --input=someRobot.urdf [--output=outputFile] [--box-collision] [--normal] [--disable-mesh-optimization] [--multi-file] [--static-base] [--tool-slot=linkName] [--help]

From Sources

python demo.py --input=someRobot.urdf [--output=outputFile] [--box-collision] [--normal] [--disable-mesh-optimization] [--multi-file] [--static-base] [--tool-slot=linkName] [--help]

Arguments

The script accepts the following arguments:

• -h, --help: Show the help message and exit.
• --input=INFILE: Specifies the urdf file to convert.
• --output=OUTFILE: Specifies the name of the resulting PROTO file.
• --normal: If set, the normals are exported if present in the URDF definition.
• --box-collision: If set, the bounding objects are approximated using boxes.
• --disable-mesh-optimization: If set, the duplicated vertices are not removed from the meshes (this can speed up a lot the conversion).
• --multi-file: If set, the mesh files are exported as separated PROTO files.
• --static-base: If set, the base link will have the option to be static (disable physics)
• --tool-slot=LinkName: Specify the link that you want to add a tool slot to (exact link name from urdf).

In your Python Code

from urdf2webots.importer import convert2urdf
convert2urdf('MY_PATH/MY_URDF.urd')

Notes

This tool have been tested using Webots R2020b on Ubuntu16.04 and Windows.
You can find the sources of these URDF files here:

• universal robot: https://github.com/ros-industrial/universal_robot/tree/kinetic-devel/ur_description
• pr2 robot: https://github.com/PR2/pr2_common/tree/kinetic-devel/pr2_description
• motoman robot: https://github.com/ros-industrial/motoman/tree/kinetic-devel/motoman_sia20d_support
• kinova robot: https://github.com/Kinovarobotics/kinova-ros/tree/kinetic/kinova_description
• gait2392 human skeleton: https://github.com/cyberbotics/urdf2webots/tree/master/tests/sources/gait2392_simbody

Acknowledgement

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.