commonroad-scenario-designer


Namecommonroad-scenario-designer JSON
Version 0.8.2 PyPI version JSON
download
home_pagehttps://commonroad.in.tum.de/tools/scenario-designer
SummaryToolbox for Map Conversion and Scenario Creation for Autonomous Vehicles
upload_time2024-07-22 11:35:17
maintainerNone
docs_urlNone
authorCyber-Physical Systems Group, Technical University of Munich
requires_python<3.12,>=3.9
licenseGPL-3.0-or-later
keywords autonomous automated vehicles driving motion planning simulation map scenario
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # CommonRoad Scenario Designer
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/commonroad-scenario-designer.svg)](https://pypi.python.org/pypi/commonroad-scenario-designer/)  
![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black)  
[![PyPI version fury.io](https://badge.fury.io/py/commonroad-scenario-designer.svg)](https://pypi.python.org/pypi/commonroad-scenario-designer/)
[![PyPI download week](https://img.shields.io/pypi/dw/commonroad-scenario-designer.svg?label=PyPI%20downloads)](https://pypi.python.org/pypi/commonroad-scenario-designer/) 
[![PyPI download month](https://img.shields.io/pypi/dm/commonroad-scenario-designer.svg?label=PyPI%20downloads)](https://pypi.python.org/pypi/commonroad-scenario-designer/)  
[![PyPI license](https://img.shields.io/pypi/l/commonroad-scenario-designer.svg)](https://pypi.python.org/pypi/commonroad-scenario-designer/)

This toolbox provides map converters for [OpenStreetMap](https://www.openstreetmap.de/karte.html) (OSM), 
[Lanelet](https://www.mrt.kit.edu/software/libLanelet/libLanelet.html) / [Lanelet2](https://github.com/fzi-forschungszentrum-informatik/Lanelet2), 
[OpenDRIVE](https://www.asam.net/standards/detail/opendrive/), and [SUMO](https://sumo.dlr.de/docs/index.html) to the [CommonRoad](https://commonroad.in.tum.de/) 
(CR) format and for some formats vice versa.  
Additionally, a graphical user interface (GUI) is included, which allows one to efficiently create and manipulate 
CommonRoad maps and scenarios.

|              Tool              |                         Path                         |                                Functionality                                 |
|:------------------------------:|:----------------------------------------------------:|:----------------------------------------------------------------------------:|
|        OpenDRIVE => CR         |        `crdesigner/map_conversion/opendrive`         |                   Conversion from OpenDRIVE to CommonRoad.                   |
|    Lanelet/Lanelet2 <=> CR     |         `crdesigner/map_conversion/lanelet2`         | Conversion from Lanelet2 to CommonRoad <br /> and from CommonRoad to Lanelet |
|           OSM => CR            |          `crdesigner/map_conversion/osm2cr`          |                      Conversion from OSM to CommonRoad.                      |
|          SUMO <=> CR           |         `crdesigner/map_conversion/sumo_map`         |              Conversion from SUMO to CommonRoad and vice versa.              |
| OpenDRIVE => Lanelet/Lanelet2  | `crdesigner/map_conversion/map_conversion_interface` |                    Conversion from OpenDRIVE to Lanelet2                     |
| Map Verification and Repairing |         `crdesigner/verification_repairing`          |                Verification and Repairing of CommonRoad maps.                |
|    CR Scenario Designer GUI    |                 `crdesigner/ui/gui`                  |    Multi-functional GUI for map conversion and scenario creation/editing.    |

## Prerequisites and Installation
We have tested the toolbox with Python 3.8, 3.9, and 3.10.
The toolbox should work under Linux, macOS, and Windows. 
Below we present two ways of installing the CommonRoad Scenario Designer: 
- Only using the CommonRoad Scenario Designer, e.g.,the GUI or integrating the scenario designer APIs into your code
- Developing code for the CommonRoad Scenario Designer

### Using the CommonRoad Scenario Designer
The recommended way of installation if you only want to use the scenario designer (i.e., you do not want to work with the code directly) is to use the PyPI package:
```bash
pip install commonroad-scenario-designer
```

### Development
First, clone the repository.
The usage of [Poetry](https://python-poetry.org/) is recommended. 
Poetry can be installed using:
```bash
curl -sSL https://install.python-poetry.org | python3 -
```
Create a new Python environment:
```bash
poetry shell
poetry install --with tests,docs,tutorials
```
We recommend to use PyCharm (Professional) as IDE.

### Common Errors during installation

#### Ubuntu 
- **Could not load the Qt platform plugin “xcb” in “” even though it was found:** Error seems to be a missing package - either libxkbcommon-x11 or libxcb-xinerama0 (both can be installed by ```sudo apt install [package_name]```). See for reference [here](https://discuss.pixls.us/t/solved-could-not-load-the-qt-platform-plugin-xcb-in-even-though-it-was-found/17677/9)


## Usage
We provide different types of usage for the _CommonRoad Scenario Designer_. Subsequently, we present for each component 
the different usage methods.

### GUI

![GUI_Screenshot](docs/source/details/images/gui_screenshot.png)

The recommended aspect ratio is 16:9 with a scaling of 100%. 
Within the GUI, you can also execute the different converters.
The GUI can either be activated via a Python API, command line, or executing a Python script.

#### Python Script

First you need to activate your python environment with the installed dependencies.  
Afterward, you can start the _CommonRoad Scenario Designer_ and the GUI will open:

```bash
$ python crdesigner/ui/gui/start_gui.py
```

#### Command Line
The GUI can be started from command line via the following two options:
```bash
$ crdesigner
$ crdesigner gui
```
Note that you have to activate first the Python environment in which the CommonRoad Scenario Designer is installed.  
You can also execute a map conversion via the commandline interface, e.g.,   
`crdesigner --input-file /input/path/l2file.osm  --output-file /output/path/crfile.xml lanelet2cr`.  
The output of `crdesigner --help` looks as follows:
```bash
Usage: crdesigner [OPTIONS] COMMAND [ARGS]...

  Toolbox for Map Conversion and Scenario Creation for Autonomous Vehicles

Options:
  --input-file PATH               Path to OpenDRIVE map
  --output-file PATH              Path where CommonRoad map should be stored
  --force-overwrite / --no-force-overwrite
                                  Overwrite existing CommonRoad file
                                  [default: force-overwrite]
  --author TEXT                   Your name
  --affiliation TEXT              Your affiliation, e.g., university, research
                                  institute, company
  --tags TEXT                     Tags for the created map
  --install-completion [bash|zsh|fish|powershell|pwsh]
                                  Install completion for the specified shell.
  --show-completion [bash|zsh|fish|powershell|pwsh]
                                  Show completion for the specified shell, to
                                  copy it or customize the installation.
  --help                          Show this message and exit.

Commands:
  crlanelet2
  crsumo
  gui
  lanelet2cr
  odrcr
  osmcr
  sumocr
  odrlanelet2`
```

### Map Converters
You can execute the different converters either via command line, calling them within your Python program via an API, 
or the GUI.

#### API
The main APIs to execute the pure conversions are located under `crdesigner/map_conversion/map_conversion_interface.py`.   
For many conversions we provide further APIs, e.g., for downloading a map from OSM.

#### GUI
The GUI provides a toolbox with which contains functionality to load maps given in formats other the CommonRoad format   
and to convert CommonRoad maps to other formats or the other formats to the CommonRoad format.

#### Saving Video

Provides the functionality to save the animation of the scenario as a mp4 file.

For error: "MovieWriter ffmpeg unavailable; using Pillow instead." try to install ffmpeg. This should solve the problem.
```bash
sudo apt-install ffmpeg
```

#### Important information

When converting OSM maps, missing information such as the course of individual lanes is estimated during the process.  
These estimations are imperfect (the OSM maps as well) and often it is advisable to edit the 
scenarios by hand via the GUI.

#### Tutorials
We also provide tutorials demonstrating how the different map converter APIs can be used.  
The tutorials include a jupyter notebook and exemplary Python scripts for each conversion.

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

```bash
cd docs/source && sphinx-build -b html . ../../public
```

The documentation can be accessed by opening `public/index.html`.  
The titles of module pages have to be set manually!  
The full documentation of the API and introducing examples can also be found [here](https://cps.pages.gitlab.lrz.de/commonroad/commonroad-scenario-designer/).

## Changelog
A detailed overview about the changes in each version is provided in the [Changelog](https://gitlab.lrz.de/tum-cps/commonroad-scenario-designer/-/blob/main/CHANGELOG.md).

## Bug and feature reporting
This release (v0.8.9) is still a BETA version.  
In case you detect a bug or you want to suggest a new feature, please report it in our [forum](https://commonroad.in.tum.de/forum/c/scenario-designer/18).   
If you want to contribute to the toolbox, you can also post it in the [forum](https://commonroad.in.tum.de/forum/c/scenario-designer/18) or contact [Sebastian Maierhofer](sebastian.maierhofer@tum.de).

## Authors
Responsible: Sebastian Maierhofer, Sebastian Mair  
Contribution (in alphabetic order by last name): Daniel Asch, Hamza Begic, Mohamed Bouhali, Florian Braunmiller, 
Tim Dang, Behtarin Ferdousi, Maximilian Fruehauf, Marcus Gabler, Fabian Hoeltke, Tom Irion, Aaron Kaefer, Anton Kluge, 
David Le, Gustaf Lindgren, Sarra Ben Mohamed, Benjamin Orthen, Luisa Ortner, Louis Pröbstle, Benedikt Reinhard, 
Maximilian Rieger, Til Stotz, Stefan Urban, Max Winklhofer

## Credits
We gratefully acknowledge partial financial support by
- DFG (German Research Fundation) Priority Program SPP 1835 Cooperative Interacting Automobiles
- BMW Group within the Car@TUM project
- Central Innovation Programme of the German Federal Government under grant no. ZF4086007BZ8

## Citation
**If you use our code for research, please consider to cite our papers:**
```
@inproceedings{Maierhofer2023,
	author = {Maierhofer, Sebastian and  Ballnath, Yannick and  Althoff, Matthias},
	title = {Map Verification and Repairing Using Formalized Map Specifications},
	booktitle = {2023 IEEE International Conference on Intelligent Transportation Systems (ITSC)},
	year = {2023},
	pages = {},
	abstract = {Autonomous vehicles benefit from correct maps to participate in traffic safely, but often maps are not verified before their usage. 
                    We address this problem by providing an approach to verify and repair maps automatically based on a formalization of map specifications in higher-order logic. 
                    Unlike previous work, we provide a collection of map specifications. 
                    We can verify and repair all possible map parts, from geometric to semantic elements, e.g., adjacency relationships, lane types, road boundaries, traffic signs, and intersections. 
                    Due to the modular design of our approach, one can integrate additional logics. 
                    We compare ontologies, answer set programming, and satisfiability modulo theories with our higher-order logic verification algorithm. 
                    Our evaluation shows that our approach can efficiently verify and repair maps from several data sources and of different map sizes. 
                    We provide our tool as part of the CommonRoad Scenario Designer toolbox available at commonroad.in.tum.de.},
}
```
```
@inproceedings{Maierhofer2021,
	author = {Sebastian Maierhofer, Moritz Klischat, and Matthias Althoff},
	title = {CommonRoad Scenario Designer: An Open-Source Toolbox for Map Conversion and Scenario Creation for Autonomous Vehicles},
	booktitle = {Proc. of the IEEE Int. Conf. on Intelligent Transportation Systems },
	year = {2021},
	pages = {3176-3182},
	abstract = {Maps are essential for testing autonomous driving functions. Several map and scenario formats are 
                    available. However, they are usually not compatible with each other, limiting their usability.  
                    In this paper, we address this problem using our open-source toolbox that provides map converters  
                    from different formats to the well-known CommonRoad format. Our toolbox provides converters for 
                    OpenStreetMap, Lanelet/Lanelet2, OpenDRIVE, and SUMO. Additionally, a graphical user interface is 
                    included, which allows one to efficiently create and manipulate CommonRoad maps and scenarios. 
                    We demonstrate the functionality of the toolbox by creating CommonRoad maps and scenarios based on 
                    other map formats and manually-created map data.},
}
```
**If you use the OpenDRIVE to CommonRoad conversion for your paper, please consider to additionally cite the corresponding paper:**
```
@inproceedings{Althoff2018b,
	author = {Matthias Althoff and Stefan Urban and Markus Koschi},
	title = {Automatic Conversion of Road Networks from OpenDRIVE to Lanelets},
	booktitle = {Proc. of the IEEE International Conference on Service Operations and Logistics, and Informatics},
	year = {2018},
	pages = {157--162},
	abstract = {Detailed road maps are an important building block for autonomous driving. They accelerate creating a 
	            semantic environment model within the vehicle and serve as a backup solution when sensors are occluded 
	            or otherwise impaired. Due to the required detail of maps for autonomous driving and virtual test 
	            drives, creating such maps is quite labor-intensive. While some detailed maps for fairly large regions 
	            already exist, they are often in different formats and thus cannot be exchanged between companies and 
	            research institutions. To address this problem, we present the first publicly available converter from
	            the OpenDRIVE format to lanelets—both representations are among the most popular map formats. 
	            We demonstrate the capabilities of the converter by using publicly available maps.},
}
```
            

Raw data

            {
    "_id": null,
    "home_page": "https://commonroad.in.tum.de/tools/scenario-designer",
    "name": "commonroad-scenario-designer",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<3.12,>=3.9",
    "maintainer_email": null,
    "keywords": "autonomous, automated, vehicles, driving, motion, planning, simulation, map, scenario",
    "author": "Cyber-Physical Systems Group, Technical University of Munich",
    "author_email": "commonroad@lists.lrz.de",
    "download_url": "https://files.pythonhosted.org/packages/42/1e/b77c3deba289729d012bf63e65e499762e9df0e1622a6c440037fabfa717/commonroad_scenario_designer-0.8.2.tar.gz",
    "platform": null,
    "description": "# CommonRoad Scenario Designer\n[![PyPI pyversions](https://img.shields.io/pypi/pyversions/commonroad-scenario-designer.svg)](https://pypi.python.org/pypi/commonroad-scenario-designer/)  \n![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black)  \n[![PyPI version fury.io](https://badge.fury.io/py/commonroad-scenario-designer.svg)](https://pypi.python.org/pypi/commonroad-scenario-designer/)\n[![PyPI download week](https://img.shields.io/pypi/dw/commonroad-scenario-designer.svg?label=PyPI%20downloads)](https://pypi.python.org/pypi/commonroad-scenario-designer/) \n[![PyPI download month](https://img.shields.io/pypi/dm/commonroad-scenario-designer.svg?label=PyPI%20downloads)](https://pypi.python.org/pypi/commonroad-scenario-designer/)  \n[![PyPI license](https://img.shields.io/pypi/l/commonroad-scenario-designer.svg)](https://pypi.python.org/pypi/commonroad-scenario-designer/)\n\nThis toolbox provides map converters for [OpenStreetMap](https://www.openstreetmap.de/karte.html) (OSM), \n[Lanelet](https://www.mrt.kit.edu/software/libLanelet/libLanelet.html) / [Lanelet2](https://github.com/fzi-forschungszentrum-informatik/Lanelet2), \n[OpenDRIVE](https://www.asam.net/standards/detail/opendrive/), and [SUMO](https://sumo.dlr.de/docs/index.html) to the [CommonRoad](https://commonroad.in.tum.de/) \n(CR) format and for some formats vice versa.  \nAdditionally, a graphical user interface (GUI) is included, which allows one to efficiently create and manipulate \nCommonRoad maps and scenarios.\n\n|              Tool              |                         Path                         |                                Functionality                                 |\n|:------------------------------:|:----------------------------------------------------:|:----------------------------------------------------------------------------:|\n|        OpenDRIVE => CR         |        `crdesigner/map_conversion/opendrive`         |                   Conversion from OpenDRIVE to CommonRoad.                   |\n|    Lanelet/Lanelet2 <=> CR     |         `crdesigner/map_conversion/lanelet2`         | Conversion from Lanelet2 to CommonRoad <br /> and from CommonRoad to Lanelet |\n|           OSM => CR            |          `crdesigner/map_conversion/osm2cr`          |                      Conversion from OSM to CommonRoad.                      |\n|          SUMO <=> CR           |         `crdesigner/map_conversion/sumo_map`         |              Conversion from SUMO to CommonRoad and vice versa.              |\n| OpenDRIVE => Lanelet/Lanelet2  | `crdesigner/map_conversion/map_conversion_interface` |                    Conversion from OpenDRIVE to Lanelet2                     |\n| Map Verification and Repairing |         `crdesigner/verification_repairing`          |                Verification and Repairing of CommonRoad maps.                |\n|    CR Scenario Designer GUI    |                 `crdesigner/ui/gui`                  |    Multi-functional GUI for map conversion and scenario creation/editing.    |\n\n## Prerequisites and Installation\nWe have tested the toolbox with Python 3.8, 3.9, and 3.10.\nThe toolbox should work under Linux, macOS, and Windows. \nBelow we present two ways of installing the CommonRoad Scenario Designer: \n- Only using the CommonRoad Scenario Designer, e.g.,the GUI or integrating the scenario designer APIs into your code\n- Developing code for the CommonRoad Scenario Designer\n\n### Using the CommonRoad Scenario Designer\nThe recommended way of installation if you only want to use the scenario designer (i.e., you do not want to work with the code directly) is to use the PyPI package:\n```bash\npip install commonroad-scenario-designer\n```\n\n### Development\nFirst, clone the repository.\nThe usage of [Poetry](https://python-poetry.org/) is recommended. \nPoetry can be installed using:\n```bash\ncurl -sSL https://install.python-poetry.org | python3 -\n```\nCreate a new Python environment:\n```bash\npoetry shell\npoetry install --with tests,docs,tutorials\n```\nWe recommend to use PyCharm (Professional) as IDE.\n\n### Common Errors during installation\n\n#### Ubuntu \n- **Could not load the Qt platform plugin \u201cxcb\u201d in \u201c\u201d even though it was found:** Error seems to be a missing package - either libxkbcommon-x11 or libxcb-xinerama0 (both can be installed by ```sudo apt install [package_name]```). See for reference [here](https://discuss.pixls.us/t/solved-could-not-load-the-qt-platform-plugin-xcb-in-even-though-it-was-found/17677/9)\n\n\n## Usage\nWe provide different types of usage for the _CommonRoad Scenario Designer_. Subsequently, we present for each component \nthe different usage methods.\n\n### GUI\n\n![GUI_Screenshot](docs/source/details/images/gui_screenshot.png)\n\nThe recommended aspect ratio is 16:9 with a scaling of 100%. \nWithin the GUI, you can also execute the different converters.\nThe GUI can either be activated via a Python API, command line, or executing a Python script.\n\n#### Python Script\n\nFirst you need to activate your python environment with the installed dependencies.  \nAfterward, you can start the _CommonRoad Scenario Designer_ and the GUI will open:\n\n```bash\n$ python crdesigner/ui/gui/start_gui.py\n```\n\n#### Command Line\nThe GUI can be started from command line via the following two options:\n```bash\n$ crdesigner\n$ crdesigner gui\n```\nNote that you have to activate first the Python environment in which the CommonRoad Scenario Designer is installed.  \nYou can also execute a map conversion via the commandline interface, e.g.,   \n`crdesigner --input-file /input/path/l2file.osm  --output-file /output/path/crfile.xml lanelet2cr`.  \nThe output of `crdesigner --help` looks as follows:\n```bash\nUsage: crdesigner [OPTIONS] COMMAND [ARGS]...\n\n  Toolbox for Map Conversion and Scenario Creation for Autonomous Vehicles\n\nOptions:\n  --input-file PATH               Path to OpenDRIVE map\n  --output-file PATH              Path where CommonRoad map should be stored\n  --force-overwrite / --no-force-overwrite\n                                  Overwrite existing CommonRoad file\n                                  [default: force-overwrite]\n  --author TEXT                   Your name\n  --affiliation TEXT              Your affiliation, e.g., university, research\n                                  institute, company\n  --tags TEXT                     Tags for the created map\n  --install-completion [bash|zsh|fish|powershell|pwsh]\n                                  Install completion for the specified shell.\n  --show-completion [bash|zsh|fish|powershell|pwsh]\n                                  Show completion for the specified shell, to\n                                  copy it or customize the installation.\n  --help                          Show this message and exit.\n\nCommands:\n  crlanelet2\n  crsumo\n  gui\n  lanelet2cr\n  odrcr\n  osmcr\n  sumocr\n  odrlanelet2`\n```\n\n### Map Converters\nYou can execute the different converters either via command line, calling them within your Python program via an API, \nor the GUI.\n\n#### API\nThe main APIs to execute the pure conversions are located under `crdesigner/map_conversion/map_conversion_interface.py`.   \nFor many conversions we provide further APIs, e.g., for downloading a map from OSM.\n\n#### GUI\nThe GUI provides a toolbox with which contains functionality to load maps given in formats other the CommonRoad format   \nand to convert CommonRoad maps to other formats or the other formats to the CommonRoad format.\n\n#### Saving Video\n\nProvides the functionality to save the animation of the scenario as a mp4 file.\n\nFor error: \"MovieWriter ffmpeg unavailable; using Pillow instead.\" try to install ffmpeg. This should solve the problem.\n```bash\nsudo apt-install ffmpeg\n```\n\n#### Important information\n\nWhen converting OSM maps, missing information such as the course of individual lanes is estimated during the process.  \nThese estimations are imperfect (the OSM maps as well) and often it is advisable to edit the \nscenarios by hand via the GUI.\n\n#### Tutorials\nWe also provide tutorials demonstrating how the different map converter APIs can be used.  \nThe tutorials include a jupyter notebook and exemplary Python scripts for each conversion.\n\n## Documentation\nTo generate the documentation from source, first install the necessary dependencies with pip:\n\n```bash\ncd docs/source && sphinx-build -b html . ../../public\n```\n\nThe documentation can be accessed by opening `public/index.html`.  \nThe titles of module pages have to be set manually!  \nThe full documentation of the API and introducing examples can also be found [here](https://cps.pages.gitlab.lrz.de/commonroad/commonroad-scenario-designer/).\n\n## Changelog\nA detailed overview about the changes in each version is provided in the [Changelog](https://gitlab.lrz.de/tum-cps/commonroad-scenario-designer/-/blob/main/CHANGELOG.md).\n\n## Bug and feature reporting\nThis release (v0.8.9) is still a BETA version.  \nIn case you detect a bug or you want to suggest a new feature, please report it in our [forum](https://commonroad.in.tum.de/forum/c/scenario-designer/18).   \nIf you want to contribute to the toolbox, you can also post it in the [forum](https://commonroad.in.tum.de/forum/c/scenario-designer/18) or contact [Sebastian Maierhofer](sebastian.maierhofer@tum.de).\n\n## Authors\nResponsible: Sebastian Maierhofer, Sebastian Mair  \nContribution (in alphabetic order by last name): Daniel Asch, Hamza Begic, Mohamed Bouhali, Florian Braunmiller, \nTim Dang, Behtarin Ferdousi, Maximilian Fruehauf, Marcus Gabler, Fabian Hoeltke, Tom Irion, Aaron Kaefer, Anton Kluge, \nDavid Le, Gustaf Lindgren, Sarra Ben Mohamed, Benjamin Orthen, Luisa Ortner, Louis Pr\u00f6bstle, Benedikt Reinhard, \nMaximilian Rieger, Til Stotz, Stefan Urban, Max Winklhofer\n\n## Credits\nWe gratefully acknowledge partial financial support by\n- DFG (German Research Fundation) Priority Program SPP 1835 Cooperative Interacting Automobiles\n- BMW Group within the Car@TUM project\n- Central Innovation Programme of the German Federal Government under grant no. ZF4086007BZ8\n\n## Citation\n**If you use our code for research, please consider to cite our papers:**\n```\n@inproceedings{Maierhofer2023,\n\tauthor = {Maierhofer, Sebastian and  Ballnath, Yannick and  Althoff, Matthias},\n\ttitle = {Map Verification and Repairing Using Formalized Map Specifications},\n\tbooktitle = {2023 IEEE International Conference on Intelligent Transportation Systems (ITSC)},\n\tyear = {2023},\n\tpages = {},\n\tabstract = {Autonomous vehicles benefit from correct maps to participate in traffic safely, but often maps are not verified before their usage. \n                    We address this problem by providing an approach to verify and repair maps automatically based on a formalization of map specifications in higher-order logic. \n                    Unlike previous work, we provide a collection of map specifications. \n                    We can verify and repair all possible map parts, from geometric to semantic elements, e.g., adjacency relationships, lane types, road boundaries, traffic signs, and intersections. \n                    Due to the modular design of our approach, one can integrate additional logics. \n                    We compare ontologies, answer set programming, and satisfiability modulo theories with our higher-order logic verification algorithm. \n                    Our evaluation shows that our approach can efficiently verify and repair maps from several data sources and of different map sizes. \n                    We provide our tool as part of the CommonRoad Scenario Designer toolbox available at commonroad.in.tum.de.},\n}\n```\n```\n@inproceedings{Maierhofer2021,\n\tauthor = {Sebastian Maierhofer, Moritz Klischat, and Matthias Althoff},\n\ttitle = {CommonRoad Scenario Designer: An Open-Source Toolbox for Map Conversion and Scenario Creation for Autonomous Vehicles},\n\tbooktitle = {Proc. of the IEEE Int. Conf. on Intelligent Transportation Systems },\n\tyear = {2021},\n\tpages = {3176-3182},\n\tabstract = {Maps are essential for testing autonomous driving functions. Several map and scenario formats are \n                    available. However, they are usually not compatible with each other, limiting their usability.  \n                    In this paper, we address this problem using our open-source toolbox that provides map converters  \n                    from different formats to the well-known CommonRoad format. Our toolbox provides converters for \n                    OpenStreetMap, Lanelet/Lanelet2, OpenDRIVE, and SUMO. Additionally, a graphical user interface is \n                    included, which allows one to efficiently create and manipulate CommonRoad maps and scenarios. \n                    We demonstrate the functionality of the toolbox by creating CommonRoad maps and scenarios based on \n                    other map formats and manually-created map data.},\n}\n```\n**If you use the OpenDRIVE to CommonRoad conversion for your paper, please consider to additionally cite the corresponding paper:**\n```\n@inproceedings{Althoff2018b,\n\tauthor = {Matthias Althoff and Stefan Urban and Markus Koschi},\n\ttitle = {Automatic Conversion of Road Networks from OpenDRIVE to Lanelets},\n\tbooktitle = {Proc. of the IEEE International Conference on Service Operations and Logistics, and Informatics},\n\tyear = {2018},\n\tpages = {157--162},\n\tabstract = {Detailed road maps are an important building block for autonomous driving. They accelerate creating a \n\t            semantic environment model within the vehicle and serve as a backup solution when sensors are occluded \n\t            or otherwise impaired. Due to the required detail of maps for autonomous driving and virtual test \n\t            drives, creating such maps is quite labor-intensive. While some detailed maps for fairly large regions \n\t            already exist, they are often in different formats and thus cannot be exchanged between companies and \n\t            research institutions. To address this problem, we present the first publicly available converter from\n\t            the OpenDRIVE format to lanelets\u2014both representations are among the most popular map formats. \n\t            We demonstrate the capabilities of the converter by using publicly available maps.},\n}\n```",
    "bugtrack_url": null,
    "license": "GPL-3.0-or-later",
    "summary": "Toolbox for Map Conversion and Scenario Creation for Autonomous Vehicles",
    "version": "0.8.2",
    "project_urls": {
        "Documentation": "https://cps.pages.gitlab.lrz.de/commonroad/commonroad-scenario-designer/",
        "Forum": "https://github.com/CommonRoad/commonroad-scenario-designer/discussions",
        "Homepage": "https://commonroad.in.tum.de/tools/scenario-designer",
        "Repository": "https://github.com/CommonRoad/commonroad-scenario-designer",
        "Source": "https://github.com/CommonRoad/commonroad-scenario-designer"
    },
    "split_keywords": [
        "autonomous",
        " automated",
        " vehicles",
        " driving",
        " motion",
        " planning",
        " simulation",
        " map",
        " scenario"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5e3318094d526346bfc52fdd316a5384d67944784b27281e04d09f9aa22733ab",
                "md5": "889deeb6438650af5ff520d44c077aa7",
                "sha256": "a5e2f99ea8ae1f4060a7180e6c5997c7d74e170a3c8e366cf804c1848fbf2d7d"
            },
            "downloads": -1,
            "filename": "commonroad_scenario_designer-0.8.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "889deeb6438650af5ff520d44c077aa7",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.12,>=3.9",
            "size": 12450675,
            "upload_time": "2024-07-22T11:35:13",
            "upload_time_iso_8601": "2024-07-22T11:35:13.619281Z",
            "url": "https://files.pythonhosted.org/packages/5e/33/18094d526346bfc52fdd316a5384d67944784b27281e04d09f9aa22733ab/commonroad_scenario_designer-0.8.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "421eb77c3deba289729d012bf63e65e499762e9df0e1622a6c440037fabfa717",
                "md5": "07bea9e20f23d6e92ff7fde64bc39055",
                "sha256": "08671121f4390a2ea8a189e435e93a9edceebcb2df58c96a681d75de07ae22be"
            },
            "downloads": -1,
            "filename": "commonroad_scenario_designer-0.8.2.tar.gz",
            "has_sig": false,
            "md5_digest": "07bea9e20f23d6e92ff7fde64bc39055",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.12,>=3.9",
            "size": 12295704,
            "upload_time": "2024-07-22T11:35:17",
            "upload_time_iso_8601": "2024-07-22T11:35:17.135629Z",
            "url": "https://files.pythonhosted.org/packages/42/1e/b77c3deba289729d012bf63e65e499762e9df0e1622a6c440037fabfa717/commonroad_scenario_designer-0.8.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-07-22 11:35:17",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "CommonRoad",
    "github_project": "commonroad-scenario-designer",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "commonroad-scenario-designer"
}
        
Elapsed time: 0.40698s