Release date: 2022-07-20


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 into 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 easier access to subtopics.

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.

In addition to this document ASAM OpenSCENARIO provides the following documents for download:

  1. An introduction to ASAM OpenSCENARIO, the different versions currently released and their differences as well as an initial roadmap by ASAM on the next plans for ASAM OpenSCENARIO (non-normative)

  2. A consolidated extended Backus–Naur form (EBNF) for ASAM OpenSCENARIO

  3. The full domain model as a library, standard.osc (non-normative)

Documents 2) and 3) are consolidations of the normative content in Section 7.2.2, "Grammar of ASAM OpenSCENARIO" and Section 8, "Domain model reference" and are provided as a convenience to users of ASAM OpenSCENARIO.

Entry points

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

Getting familiar with ASAM OpenSCENARIO

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

Understanding the concept of ASAM OpenSCENARIO

Section 6, "Conceptual overview" provides a summary of the features, terminology and specific concepts used in ASAM OpenSCENARIO.

ASAM OpenSCENARIO language specification

Section 7, "Language reference manual" contains the normative specification of the language, its syntax, grammar, semantics and more. This documentation helps to start creating scenarios right away, and in getting familiar with the domain-specific language that is used in ASAM OpenSCENARIO.

Using the domain model

Section 8, "Domain model reference" contains information how to use the domain model. The documentation defines the different entities in the "world" of ASAM OpenSCENARIO.


Section 9, "User guide" contains guidelines how to write reusable scenarios, and how to properly format ASAM OpenSCENARIO code.

Section 9.3, "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.2.0

ASAM OpenSCENARIO Migration provides information about how to migrate to this version of ASAM OpenSCENARIO for an audience already familiar with ASAM OpenSCENARIO 1.2.0. The migration guide focuses on converting existing ASAM OpenSCENARIO 1.2.0 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.2.0 is based on an XML format. This version of ASAM OpenSCENARIO is based on a programing language.

Please consult the documentation of this version of ASAM OpenSCENARIO, even if the primary interest is in migrating from ASAM OpenSCENARIO 1.2.0.