Skip to content

coincar-sim/coincarsim_getting_started

Repository files navigation

Build Status

CoInCar-Sim

An Open-Source Simulation Framework for Cooperatively Interacting Automobiles

This is the main readme of the ROS Simulation Framework CoInCar-Sim, developed jointly within the Priority Program 1835 "Cooperatively Interacting Automobiles" of the German Science Foundation (DFG) and within the TechCenter A-Drive funded by the state of Baden-Württemberg.

Visualization of the framework (rviz)

The motivation and concept is explained in our publication [DOI] and these slides.

General Information

Installation requires Linux as operating system. The framework is developed and tested under Ubuntu 18.04.

Prerequisites

In order to use the framework, you need to install the following packages (installable via apt install)

Installation

This section describes the installation of the framework, assuming the prerequisites have already been installed.

For the full installation starting at a clean Ubuntu 18.04, have a look at how Travis does it in about 15 minutes: Build Status

1) Source ROS

  • open a terminal
  • source ROS
    • source /opt/ros/melodic/setup.bash
    • you might want to add this to your .bashrc

2) Use the script to download and install the framework

  • navigate to the folder where you want to place the framework
  • execute the script

Alternative Installation

2a) Download the script and execute the local one

  • download the desired *.rosinstall file from the folder ws_config (or clone this repo)
    • this config file contains the url of all source dependencies for their automated download in step 3
    • recommended: use simulation_framework_latest.rosinstall
  • also download the script and do the above steps by starting
    • $ ./setup_workspace.sh simulation_framework_latest.rosinstall

2b) Set up and build the workspace yourself

  • download the desired *.rosinstall file from the folder ws_config (or clone this repo)
    • this config file contains the url of all source dependencies for their automated download in step 3
    • recommended: use simulation_framework_latest.rosinstall
  • set up a catkin workspace from the *.rosinstall file you just downloaded
    • $ mkdir catkin_ws && cd catkin_ws
    • catkin_ws$ wstool init src PATH_TO_ROSINSTALL_FILE.rosinstall
  • build the workspace
    • catkin_ws$ catkin build
  • source the build-files
    • catkin_ws$ source devel/setup.bash

Usage

3) Launch the framework

  • source the build-files
    • catkin_ws$ source devel/setup.bash
  • start the simulation framework by launching the main launchfile:

4) Play with it

5) Contribute

  • fork simulation_initialization_ros_tool and modify the launchfiles/settings/workspace config to simulate (parts of) your vehicle
  • fork other components or create new vehicles to modify and/or extend the functionality

6) Stay tuned

  • if you did choose the latest version, you can update it with
    • catkin_ws$ wstool update

Changelog

  • June 2020: xenial support has been dropped in rosinterface_handler with this commit, so it is also dropped here; as a temporary solution, you might work with an old commit of rosinterface_handler

License

See the respective packages for license issues.

Citation

If you are using CoInCar-Sim for scientific research, we would be pleased if you would cite our publication [DOI]:

@inproceedings{Naumann2018CoInCarSim,
  title     = {{C}o{I}n{C}ar-{S}im: An Open-Source Simulation Framework for Cooperatively Interacting Automobiles},
  author    = {M. {Naumann} and F. {Poggenhans} and M. {Lauer} and C. {Stiller}},
  booktitle = {Proc. IEEE Int. Conf. Intelligent Vehicles},
  year      = {2018},
  address   = {Changshu, China},
  month     = {June},
  pages     = {1879--1884},
  doi       = {10.1109/IVS.2018.8500405}
}

About

Readme and script for single-line installation

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages