ASAM OpenSCENARIO 2.0.0

This is a Public Release Candidate of ASAM OpenSCENARIO 2.0.0 not the final release.

  • The content is ready to be used.

  • This is a phase that allows users/implementers to start applying the upcoming standard while still being able to submit feedback

  • This PRC is available to everyone free of charge

  • This phase will run until the end of Q1 2022, after which ASAM aims to release the full version of ASAM OpenSCENARIO 2.0.0

  • Core goal of the phase: proactively focus on implementations in order to uncover issues and inconsistencies.

  • This goal will be actively pursued in the ASAM Implementers Forum. Stay tuned for more information!

  • No major changes to the content are planned.

  • Minor changes will take place : documentation improvement, clarification, minor fixes.

  • The wording on the standard documents during this phase will be continually improved, this includes better alignment and consistency between sections.

  • Should major problems be uncovered, the project will attempt to address them in a non-breaking way, but if this is unfeasible the project reserves the right to make breaking changes

Disclaimer

This document is the copyrighted property of ASAM e. V. In alteration to the regular license terms, ASAM allows unrestricted distribution of this standard. ยง2 (1) of ASAM’s regular license terms is therefore substituted by the following clause: "The licensor grants everyone a basic, non-exclusive and unlimited license to use the standard ASAM OpenSCENARIO".

This documentation landing page is intended as a starting point to get familiar with ASAM OpenSCENARIO 2.0.0.

The ASAM OpenSCENARIO documentation helps to understand how to use, apply and implement the ASAM OpenSCENARIO standard.

Features of this documentation

This section explains enhanced functionality for accessing the content of this standard.

On the top right, a full text search is present. When entering one or more terms to the search bar, the entire content of the standard is searched and topics that contain those terms are listed.

On the right, a table of contents for subsections is present. This additional table enables to access subtopics more easily.

Within continuous text, content is linked where it is useful to provide related and additional content or more specific explanations to a subject.

To return to this page click on ASAM OpenSCENARIO in the table of contents on the left hand side.

TODO: Add explanations for the downloads and Related ASAM Standards lists.

Entry points

This section provides common entry points where to start reading, depending on knowledge, interests and needs.

Getting familiar with ASAM OpenSCENARIO

The section Introduction provides an overview about ASAM OpenSCENARIO, the target group, and the deliverables provided with ASAM OpenSCENARIO.

Understanding the concept of ASAM OpenSCENARIO

The section Conceptual overview provides a summary of the features, terminology and specific concepts used in ASAM OpenSCENARIO.

ASAM OpenSCENARIO normative description

The section Language reference manual contains a complete definition of the language, its syntax, grammar, semantics and more. This documentation helps to start creating scenarios right away, and getting familiar with the domain-specific language that is used in ASAM OpenSCENARIO.

Using ASAM OpenSCENARIO

The section User guide contains guidelines how to write reusable scenarios, and how to properly format ASAM OpenSCENARIO code.

In addition the following guidelines are provided within this section:

Extending the domain model

The section Extending the domain model contains explanations, how to define various entities in ASAM OpenSCENARIO, for example actors, structs or actions. New entities can then be added and used in scenarios.

Migrating from ASAM OpenSCENARIO 1.x

The section Migrating from OpenSCENARIO 1.x provides information about how to migrate to this version of ASAM OpenSCENARIO for an audience already familiar with ASAM OpenSCENARIO 1.x. The migration guide focuses on converting existing ASAM OpenSCENARIO 1.x scenarios to this version of ASAM OpenSCENARIO. A collection of examples shows best practices of a smooth migration.

This version of ASAM OpenSCENARIO uses a different approach to describe scenarios, and has a richer set of features. ASAM OpenSCENARIO 1.x is based on an XML format. This version of ASAM OpenSCENARIO is based on a programing language.

Please consult the user guide and the reference manual of this version of ASAM OpenSCENARIO, even if the primary interest is to migrating from ASAM OpenSCENARIO 1.x.

Using predefined workflows

The section Use cases and workflows contains recommended workflows for specific ASAM OpenSCENARIO use cases.

Using the domain model

The section Domain Model Reference contains information how to use the domain model. The documentation defines the different entities in the "world" of ASAM OpenSCENARIO.