8000 GitHub - cariad-tech/esmini: a basic OpenSCENARIO player · GitHub
[go: up one dir, main page]

Skip to content
  • cariad-techPublic
    forked from esmini/esmini

    About

    a basic OpenSCENARIO player

    Resources

    Code of conduct

    Contributing

    Stars

    0 stars

    Watchers

    0 watching

    Forks

     
     

    Latest commit

     

    History

    3,162 Commits

    Folders and files

    NameName
    Last commit message
    Last commit date
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     

    Repository files navigation

    Environment Simulator Minimalistic (esmini)

    esmini is a basic OpenSCENARIO player

    License: MPL 2.0 Build status

    Screenshot

    It contains the following main libraries:

    • RoadManager (esminiRMLib). A library providing an interface to road networks described in the OpenDRIVE format.
    • ScenarioEngine (esminiLib). The main library providing a viewer and API interface to traffic scenarios described in the OpenSCENARIO format. This library includes RoadManager.

    and a few applications that can be used as is or provide ideas for customized solutions:

    • esmini. A scenario player application linking esmini modules statically.
    • esmini-dyn. A minimalistic example using the esminiLib to play OpenSCENARIO files.
    • odrplot. Produces a data file from OpenDRIVE for plotting the road network in Python.
    • odrviewer. Visualize OpenDRIVE road network with populated dummy traffic.
    • replayer. Re-play previously executed scenarios.
    • osireceiver. A simple application receiving OSI messages from esmini over UDP.

    Repository: https://github.com/esmini/esmini

    Pre-built demo packages are available here. Unzip, navigate to "esmini\run\esmini" and run any of the example scripts. See more info below under Binaries and demos.

    esmini supports OpenSCENARIO v1.1 (from esmini v2.7) and v1.0 (from esmini v1.5). In order to run older versions (i.e. v0.9.1) ASAM provides a transformation scheme (migration0_9_1to1_0.xslt, part of the OpenSCENARIO release bundle) that can be used with tools for automatic migration of XML files.

    Please note that the OpenSCENARIO coverage is limited, which means that not all features of OpenSCENARIO are supported. The functionalty grows slow but steady, based on need and contributions.

    The code was initially a result from the Swedish collaborative research project Simulation Scenarios, and is now further developed based on users need and OpenSCENARIO development.

    User guide: https://esmini.github.io

    Brief roadmap is published here.

    For more information about the esmini software parts, see Inner Workings of esmini.

    Background

    The purpose of this implementation (started 2018) was initially to explore and get familiar with the emerging OpenSCENARIO data format. The development aimed at supporting various platforms such as Windows, Mac, Linux, and Android. Tool integration and portability were high priorities. It should be easy to use for native C++ applications as well as other frameworks like Unity3D (C#) and MATLAB/Simulink, among many others. Initially, focus was more on features than quality.

    Since then the purpose has grown, contributing to the spread and harmonization of OpenSCENARIO. esmini is also being used in other applications and test platforms. It grows slowly but steady, both in terms of functionality and quality, e.g. documentation, code refactorizations, continuous integration including static code analysis, and test coverage on both unit and application levels.

    Binaries and demos

    Windows, Linux and Mac supported

    Latest release including source, binaries and demo packages is found here: https://github.com/esmini/esmini/releases/latest

    3D models used by the example scenarios are included in the demo packages. They are also available here. Unpack into esmini/resources. These assets works on all platforms. Environment models (roads, landscape, buildings...) have been created using VIRES Road Network Editor.

    See User Guide for more information.

    esmini shared library

    The easiest way of integrating esmini in your custom application is to link the all inclusive shared library ScenarioEngineDLL. In spite of the name it's available also on Linux and Mac. See User Guide "Hello World" tutorial on how to create a minimalistic application based on it.

    OSI support

    In addition to internal API (example) for getting information about the ongoing simulation, e.g. road width and road user position, esmini collects everything into an OSI :: groundtruth structure. This structure can be 1. stored in an OSI trace-file, 2. retrieved via UDP and/or 3. retrieved directly via API (see esminiLib.hpp).

    Note: Only parts of OSI groundthruth is populated.

    Hello World tutorial includes an example of how to fetch OSI groundtruth.

    Current versions used by esmini:

    • OSI version: v3.5.0
    • Google Protobuf version: v3.15.2

    Script that compiles OSI for Win/Linux/Mac available here. Run in bash, also on Windows, e.g. GIT bash.

    Unity support

    esmini shared library works fine also in Unity (Win, Linux, Mac). A simple example can be downloaded from here. The package contains everything needed to get going:

    • esmini library C# wrapper
    • a generic scenario player script
    • a few example scenarios (OpenSCENARIO + OpenDRIVE) including 3D models
    • plugins for all platforms (can be updated of course)
    • and finally a scene connecting the player script to a game object

    Run:

    1. Import package (Import Package -> Custom Package).
    2. Load the scene (Assets/Scenes/esmini-scene).
    3. Then just press play-button.

    Select (click on) esmini-player in Hierarchy to show up in Inspector, where you can specify scenario file and a few parameters. Note that scenario file and dependent OpenDRIVE and optional 3D scenegraph file must be present in StreamingAssets folder.

    Plugins can be updated, but NOTE that you need to restart Unity to (re)load shared library plugins. And, of course, scenario files and other content can be added or replaced.

    esmini & Python

    see User Guide Hello-World tutorial.

    Related work

    scenariogeneration

    scenariogeneration is a Python based scenario creation framework. The idea is to write scenarios in a high-level script format and automatically generate and run linked OpenDRIVE and OpenSCENARIO XML counterparts. It supports parameter sweeps to create multiple variants of a parameterized scenario.

    ALKS scenarios

    OSC-ALKS-scenarios is a collection of scenarios for Automated Lane Keeping System testing. "BMW has taken on the task of implementing the test scenarios from the ALKS regulation using OpenSCENARIO and OpenDRIVE resulting in a bundle of XML files executable with standard compliant simulators."

    NCAP scenarios

    OSC-NCAP-scenarios is a collection of scenarios based on Euro NCAP Test Protocols. "As the Euro NCAP scenarios are widely used, Vector decided to contribute the implementation of these scenarios using the ASAM standards."

    Online OpenDRIVE viewer

    odrviewer.io is an excellent interactive online OpenDRIVE viewer. Move around, zoom and inspect elements of the road network like roadID, laneID, successor and predecessor.

    OpenDRIVE plugin for Unreal Engine

    brifsttar/OpenDRIVE plugin allows you to manipulate OpenDRIVE road networks in Unreal Engine. It's based on esmini RoadManager (esminiRMLib).

    Editors

    Blender Driving Scenario Creator add-on lets you create OpenDRIVE and OpenSCENARIO based scenarios.

    Carla Simulator

    Carla is an Unreal based open source simulator worth to check out.

    OpenMSL

    Open Source Model & Simulation Library is a central hub for simulation entities for virtual ADAS testing. It runs a co-simulation with esmini in a GitHub action for sensor model testing and therefore demonstrates its application with other simulation models.

    Data formats

    OpenDRIVE describes the road network, the static part of a scenario.

    OpenSCENARIO describes the dynamic content on top of a road network, e.g. traffic maneuvers and weather conditions.

    About

    a basic OpenSCENARIO player

    Resources

    Code of conduct

    Contributing

    Stars

    0 stars

    Watchers

    0 watching

    Forks

    Releases

    Packages

    Used by

    Contributors

    Languages

    0