| Overview | Download | Install | Use | License | Contact |

ENSEMBLE Launch

ENSEMBLE Launch is a Command Line Interface implementing Multibrand platooning for ENSEMBLE within traffic simulators. Please find more information in the documentation

drawing

Overview

ENSEMBLE is an effort to pave the way to multibrand truck platooning. The objective of this repository is to provide a simple way to launch and execute simulations in different traffic simulation platforms.

This software application describes a model for the platooning driver model which is used within the European project of ENSEMBLE.

Here we describe how we think the structure of the cooperation between the specification and the traffic simulation platform is implemented.

Download

In order to install run in your command line tool:

Or obtain direct download here.

Install

Developer environment

Be sure to obtain python and pip. This repository as a standard python package with support for CLI interfacing to improve the interaction.

Get the dependencies for this repository before installing via anaconda (Only MacOSX/Linux)

cd ensemble
conda env create -f docs/environment.doc.yml
conda activate ensemble-doc

You can try and test functionalities by installing the package in testing mode.


pip install -r requirements_dev.txt
pip install --editable .

Note: Be sure to be in the folder before launching the pip instruction

Use

In order to use this tool, first check the help options via:

ensemble --help

Which should print the available options

❯ ensemble --help
Usage: ensemble [OPTIONS] COMMAND [ARGS]...

  Scenario launcher for ENSEMBLE simulations

Options:
  --verbose
  --platform TEXT  'symuvia' or 'vissim'
  --help           Show this message and exit.

Commands:
  check   Diagnoses files consistancy and simulator availability
  launch  Launches an escenario for a specific platform

Check possible options by typing ensemble launch or ensemble check. Execute an scenario via

ensemble launch -s 'file_scenario.inpx' -s 'file_layout.layx' -l 'C:\my\path\to\vissim'

Documentation

Documentation is available here or in the docs folder. In order to build the documentation

make docs

License

The code here contained is licensed under TBD

Contact

If you run into problems or bugs, please let us know by creating an issue an issue in this repository.

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.****