Scenario Execution

The scenario_execution package is the core package of Scenario Execution for Robotics. It provides functionalities such as parsing, py-trees creation and execution.

Furthermore, it provides the following scenario execution libraries:

• standard.osc: The OpenSCENARIO DSL standard library. It is slightly modified to be in sync with the feature set of scenario execution and imports standard_base.osc.
• standard_base.osc: The base parts of the OpenSCENARIO DSL standard library such as units and basic structs. For convenience, numerical struct members are initialized with 0.
• robotics.osc: robotic-specific specifications.
• helper.osc: helper actions such as logging or running external processes.

Changelog for package scenario_execution

1.8.0 (2026-09-28)

• The action catalog lists enums with their members: list_actions has an enums group, each entry carrying values, and get_action_details finds an enum by name (#101)
• get_scenario_parameters reads a .sce scenario model file, which failed to parse before, and gives the same parameters as the scenario it was generated from (#132)
• A scenario's parse names the files it read (#129)
• A misspelled core library import is refused when external imports are skipped (#131)
• A relative string import resolves against the importing file's directory (#130)
• A scenario model file that cannot be loaded raises, naming the file (#133)
• Contributors: fred-labs

1.7.0 (2026-09-21)

• A recording that could not be closed is stoppable, and says so if it was not (#119)
• Contributors: fred-labs

1.6.0 (2026-09-18)

• run_process: stop a process at shutdown whose action never called execute()
• The version lives in package.xml alone, and a release is one command, one PR and one tag (#107)
• Measure a scenario's durations on simulated time under use_sim_time (#104)
• Keep the traceback when a scenario run fails (#92)
• Report an action declared by two libraries whichever is imported first (#98)
• Read a duration as a duration, and an action name as its library's (#95)
• Refuse a parameter that is its own value, instead of recursing until Python stops (#96)
• Read a scenario file as UTF-8, and place a decode failure in it (#94)
• Fix positional override binding for structs declared with inherits (#91)
• Support the until directive, and the if guard on an event reference (#88)
• Cancel a long-running action mid-scenario, not only at teardown (#85)
• Keep a bool parameter override true when the parameter has a default (#86)
• Record how fast the tree ticked, and which behavior spent the time (#84)
• Drop the lexer predicate that defeats ANTLR's DFA cache (#82)
• Get latest scenario state (#81)
• Extend the introspection interface: get_action_details, describe_scenario, and a standalone MCP server (#79)
• add introspection interface (#75)
• Tracing (#76)
• Feature/process log check (#74)
• Contributors: Florian Mirus, fred-labs

1.5.0 (2026-06-14)

• Support step-based simulators
• Fix for python 3.13 (#65)
• support multiple --post-run (#63)
• Support adding modifiers (#60)
• improve error message (#57)
• add custom field in junit xml: start_time (#56)
• run_process: fix cleanup (#55)
• Update pytrees version (#53)
• Contributors: Adi Vardi, Frederik Pasch

1.4.0 (2025-11-27)

• Add external interface
• support creating override template

File truncated at 100 lines see the full file