scenariogeneration
The Python scenariogeneration package is a collection of libraries for generating OpenSCENARIO (.xosc) and OpenDRIVE (.xodr) XML files.
This combined package (which includes the former pyoscx, pyodrx) can be used to jointly generate OpenSCENARIO based scenarios with interlinked OpenDRIVE based road network maps. Nevertheless, it is still possible to separately generate OpenSCENARIO or OpenDRIVE files by using only a subset of the provided functionality.
The package consists of the scenario_generator module and two Python subpackages, xosc (OpenSCENARIO) and xodr (OpenDRIVE), together with some support functionality for auto generation with parametrization as well as easy viewing with esmini.
The user documentation can be found here, the API documentation here and the change log in release_notes.md
Please note that this is not an official implementation of either OpenSCENARIO or OpenDRIVE.
Coverage
As of V0.11.0, the coverage of the modules varies:
- The xosc module has full coverage of OpenSCENARIO V1.0.0, and most of V1.1.0 , V1.2.0 and v1.3.1, if something is missing please raise an issue or make a pull request.
- The xodr module has coverage of basic roads, junctions, signals, and objects, based on OpenDrive (V 1.7.1).
For more details se xodr_coverage.txt and xosc_missing_features.txt
Getting Started
pip install scenariogeneration
then run any of the examples provided
Prerequisites
Been tested with Python >3.6.9. With Python versions <3.7 the order of certain xml-elements might not be the same between generations.
Installing
pip install scenariogeneration
Usage
Please see the user guide for more information: https://pyoscx.github.io/
Running with esmini
Esmini can be used to visualize the generated scenarios. Visit https://github.com/esmini/esmini and follow the "Binaries and demos" section. Your scenarios can be visualized directly by making use of esmini in the following way:
from scenariogeneration import esmini
def Scenario(ScenarioGenerator): ...
if __name__ == "__main__":
s = Scenario()
esmini(s,esminipath ='path to esmini', index_to_run = 'first')
where index_to_run can be 'first', 'random', 'middle' or an integer, and esmini will run that scenario/road for you.
Related work
esmini
esmini is a basic OpenSCENARIO player
clothoids
pyclothoids, used for construction and optimization of clothoids geometries
blender implementation
Authors
See AUTHORS file
Data formats
The wrappers is based on the OpenSCENARIO and OpenDRIVE standards.
describes the static content of a scenario, like the road, lanes, signs and so on.
describes the dynamic content on top of a road network, e.g. traffic maneuvers, weather conditions, and so on.
5 maintainers
Metadata
5 maintainers
Release files for scenariogeneration 0.16.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| scenariogeneration-0.16.7.tar.gz | 321.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| scenariogeneration-0.16.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 602.4 kB
Release files / scenariogeneration-0.16.7.tar.gz
| Download URL | scenariogeneration-0.16.7.tar.gz |
|---|---|
| Size | 321.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ea4f4040214e5d94e8415bba863a11b6fcbc900d4a9d1a6c591e2a947d43cddd
|
|
BLAKE2b-256 checksum How to use checksums |
5a7afcca5bbf8a2912142234cd5d50abe4656754734c75cd1f845b829b1cc177
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.12
|
Release files / scenariogeneration-0.16.7-py3-none-any.whl
| Download URL | scenariogeneration-0.16.7-py3-none-any.whl |
|---|---|
| Size | 280.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f8cea9067c0b6f8be4c17ded3b3d5945c9e3f1003085155423a57a1df4c21b22
|
|
BLAKE2b-256 checksum How to use checksums |
dc7536d063d78f20a1df85396d3631ca69a6e60d7a0ed3e64e3119122efb9902
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.12
|
