Giter Club home page Giter Club logo

esmini's Introduction

Environment Simulator Minimalistic (esmini)

esmini is a basic OpenSCENARIO player

License: MPL 2.0 Build Status

Screenshot

It contains the following main modules:

  • RoadManager. A library providing an interface to road networks described in the OpenDRIVE format.
  • ScenarioEngine. A library providing an interface to traffic scenarios described in the OpenSCENARIO format.
  • ViewerBase. A library based on OpenSceneGraph providing a simple visualization of the road and scenario.
  • ScenarioEngineDLL. A library packaging the above three modules into a single library with a simplified API.

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

  • EnvironmentSimulator. A simple scenario player linking ScenarioEngine and Viewer modules statically.
  • ScenarioViewer. A minimalistic example using the scenarioengine DLL to play OpenSCENARIO files.
  • EgoSimulator. An example of how to integrate a simple Ego vehicle with the scenario engine.
  • OdrPlot. Produces a data file from OpenDRIVE for plotting the road network in Python.
  • OpenDriveViewer. Visualize OpenDRIVE road network with populated dummy traffic.
  • Replayer. Re-play previously executed scenarios.

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

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

Please note: From version 1.5 esmini only supports OpenSCENARIO v1.0. All demo scenarios has been updated from 0.9.1 to 1.0. ASAM provides a transformation scheme (migration0_9_1to1_0.xslt, part of the OpenSCENARIO 1.0 release bundle) that can be used with tools for automatic migration of XML files.

The code is a result from the Swedish collaborative research project Simulation Scenarios.

Background

The purpose of this implementation was 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, the project outcomes should be capable of incorporation in native C++ applications as well as other frameworks like Unity3D (C#) and MATLAB/Simulink, among many others.

Although allowed by the license this implementation is not primarily intended for production use. The code was developed ad hoc to answer research questions connected with the ongoing project. Therefore, code quality, as expected from standard production applications, is lacking when it comes to clarity, structure, comments, error handling and coding guidelines.

OpenSCENARIO coverage is limited as it was developed on demand and defined by the research scope. Moreover, since the Simulation Scenario project is closed, no formal support should be expected from the initial contributors.
Nevertheless, regarding the above stated limitations, it was decided to release the code as is, as a public outcome from the project. It can hopefully serve as guidance or just inspiration for those aspiring to build similar tools, or even get accustomed with the OpenSCENARIO format. And of course, all contributions to further development are welcome!

Binaries and demos

Windows, Linux and Mac supported

Latest release is found here: https://github.com/esmini/esmini/releases/latest

All builds, successful and unsuccessful ones :), are available at the CI service AppVeyor/esmini. Click on a job, then find files under the Artifact tab.

On Mac the zip-package might be put in quarantine, to release it: xattr -d com.apple.quarantine file.zip or even better: xattr -c file.zip

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.

Build

If you want to build yourself, please find some instructions here.

Related work

pyoscx

pyoscx is a Python based scenario creation framework. The idea is to write scenarios in a high-level script format and automatically generate the OpenSCENARIO 1.0 XML counterpart.

Scenario video clip generator

esmini-visualizer is a tool to automatically generate video visualizations of scenarios.

Note that it does not seem to work with Anti-Alias filtering. Therefore make sure to run EgoSimulator without Anti-Alias by providing argument "--aa_mode 0".

Scenario editor

RControlStation scenario editor. An embryo to an OpenSCENARIO editor, part of Self-Driving Model Vehicle Platform (SDVP).

Instruction:

  1. git clone https://github.com/vedderb/rise_sdvp
  2. cd rise_sdvp/Linux/RControlStation
  3. git clone https://github.com/esmini/esmini esmini
  4. Edit RControlStation.pro and uncomment the line: #DEFINES += HAS_SIM_SCEN
  5. Build the project. The editor is the last tab in RControlStation.

The implementation is very limited at this point, but some things can be edited and the scenario can be executed and observed from above, as well as exported to the other tools. You have to start by importing one of the existing scenarios into the editor, as it cannot make a scenario from scratch.

Carla Simulator

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

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.

esmini's People

Contributors

eknabevcc avatar aolsso65 avatar erikgunnarssonhiq avatar erikhenrikssonhiq avatar vedderb avatar balp avatar bertrandrichard avatar eknabe avatar fabianoboril avatar brunovti avatar mguldogu avatar davidhesselbomvcc avatar esmini avatar dbestelle avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.