/open-simulation-interface

A generic interface for the environmental perception of automated driving functions in virtual scenarios.

Primary LanguagePythonOtherNOASSERTION

Open Simulation Interface (OSI)

ProtoBuf CI Builds

The Open Simulation Interface [1] (OSI) is a generic interface based on Google's protocol buffers for the environmental perception of automated driving functions in virtual scenarios.

As the complexity of automated driving functions rapidly increases, the requirements for test and development methods are growing. Testing in virtual environments offers the advantage of completely controlled and reproducible environment conditions.

For more information on OSI see the official documentation or the class list for defined protobuf messages.

[1] Hanke, T., Hirsenkorn, N., van-Driesten, C., Garcia-Ramos, P., Schiementz, M., Schneider, S. & Biebl, E. (2017, February 03). A generic interface for the environment perception of automated driving functions in virtual scenarios. Retrieved January 25, 2020, from https://www.hot.ei.tum.de/forschung/automotive-veroeffentlichungen/

Usage

For usage examples, please refer to the official documentation:

Installation

Dependencies

Install cmake 3.10.2:

$ sudo apt-get install cmake

Install pip3 and missing python packages:

$ sudo apt-get install python3-pip python3-setuptools

Install protobuf:

$ sudo apt-get install libprotobuf-dev protobuf-compiler
Build and install for C++ usage:
$ git clone https://github.com/OpenSimulationInterface/open-simulation-interface.git
$ cd open-simulation-interface
$ mkdir build
$ cd build
$ cmake ..
$ make
$ sudo make install
Install for Python usage:

Local:

$ git clone https://github.com/OpenSimulationInterface/open-simulation-interface.git
$ cd open-simulation-interface
$ sudo pip3 install virtualenv
$ virtualenv -p python3 venv
$ source venv/bin/activate
$ python3 -m pip install .

Global:

$ git clone https://github.com/OpenSimulationInterface/open-simulation-interface.git
$ cd open-simulation-interface
$ sudo pip3 install .

For Windows installation see here for more information.