PMSF py-osc2 is a Python package for working with ASAM OpenSCENARIO DSL 2.x scenario files.
Note that this package is currently provided as a community service. It is based on the current public review draft of version 2.1.0 of the language, which is non-final, and might include updates based on current developments. It is offered without any support and should be considered draft alpha quality.
Specifically both the public review draft standard, this rendering of the grammar in ANTLR4, and any intermediate fixes might contain errors.
Nor is the rendering of the grammar in ANTLR4 intended for purposes other than the goals of this package.
If you are interested in OpenSCENARIO DSL development, please feel free to contact us directly.
- ANTLR4-based parser and lexer for parsing ASAM OpenSCENARIO DSL 2.x files.
- Simple syntax checking driver
osc2parser
for parsing and checking ASAM OpenSCENARIO DSL 2.x files.
The source code is currently hosted on GitHub at: https://github.com/PMSFIT/py-osc2
Binary installers for the latest released version are available at the Python Package Index (PyPI).
# or PyPI
pip install py-osc2
When rebuilding the parser from its grammar:
To rebuild the parser, you need setuptools-antlr in addition to the normal dependencies above:
pip install setuptools-antlr
To rebuild the package with a rebuilt parser, execute:
python setup.py antlr build
or for installing:
python setup.py antlr install
or alternatively to install in development mode:
python setup.py antlr develop
(C) 2021-2024 PMSF IT Consulting Pierre R. Mai
After installation of the package, an executable script, called
osc2parser
, is available to parse and check ASAM OpenSCENARIO DSL 2.x
files:
osc2parser examples/demo.osc
This script can optionally also output a tree-view of the parsed file contents:
osc2parser -t examples/demo.osc