Skip to main content

Parser and converter from OpenDRIVE to lanelets

Project description

OpenDRIVE 2 Lanelet - Converter

We provide the code for an OpenDRIVE ( to lanelets ( converter, which has been introduced in our paper: M. Althoff, S. Urban, and M. Koschi, "Automatic Conversion of Road Networks from OpenDRIVE to Lanelets," in Proc. of the IEEE International Conference on Service Operations and Logistics, and Informatics, 2018.

Documentation Status PyPI version Supported python versions License


Installing from source

git clone
cd opendrive2lanelet
python install

Using pip:

pip install opendrive2lanelet

Optionally, for using the gui packages:

pip install opendrive2lanelet[GUI]

Example OpenDRIVE Files

Download example files from:


Using our provided GUI

Start the GUI with opendrive2lanelet-gui

GUI screenshot

Converting a file with the command line

Execute opendrive2lanelet-convert input_file.xodr -o output_file.xml

If you want to visualize the Commonroad file, use the opendrive2lanelet-visualize command.

Using the library in your own scripts

from lxml import etree
from opendrive2lanelet.opendriveparser.parser import parse_opendrive
from import Network
from from commonroad.common.file_writer import CommonRoadFileWriter

# Import, parse and convert OpenDRIVE file
with open("{}/opendrive-1.xodr".format(os.path.dirname(os.path.realpath(__file__))), "r") as fi:
	open_drive = parse_opendrive(etree.parse(fi).getroot())

road_network = Network()

scenario = road_network.export_commonroad_scenario()
# Write CommonRoad scenario to file
from commonroad.common.file_writer import CommonRoadFileWriter
commonroad_writer = CommonRoadFileWriter(
            source="OpenDRIVE 2 Lanelet Converter",
with open("{}/opendrive-1.xml".format(os.path.dirname(os.path.realpath(__file__))), "w") as fh:

Just parsing the OpenDrive .xodr file

from lxml import etree
from opendrive2lanelet.opendriveparser.parser import parse_opendrive

with open("input_opendrive.xodr", 'r') as fh:
	open_drive = parse_opendrive(etree.parse(fh).getroot())

# Now do stuff with the data
for road in open_drive.roads:
	print("Road ID: {}".format(


The documentation is published on Read the Docs.

To generate the documentation from source, first install the necessary dependencies with pip:

pip install -r docs_requirements.txt

Then you can run

cd docs && make html

for example.

Known Problems

  • When trying to use the under Wayland, the following error occurs:
    This application failed to start because it could not find or load the Qt platform plugin "wayland" in "".
    Available platform plugins are: eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, xcb.
    Reinstalling the application may fix this problem.
    Set the platform to xcb using this command: export QT_QPA_PLATFORM="xcb"


Benjamin Orthen (current maintainer)
Stefan Urban

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for opendrive2lanelet, version 1.1.0
Filename, size & hash File type Python version Upload date
opendrive2lanelet-1.1.0-py3-none-any.whl (85.7 kB) View hashes Wheel py3
opendrive2lanelet-1.1.0.tar.gz (54.5 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page