SensoDat: Simulation-based Sensor Dataset of Self-driving Cars

Latest Release on Zendodo:

Original Paper Artifact:

SensoDat is a dataset of self-driving car simulation data (30K executed simulations). Concretely, it contains: - Simulation description data in ASAM OpenDRIVE format - Sensor data as time series of 81 sensors/properties

Associated Paper

```{bibtex} @inproceedings{sensodat, author = {Christian Birchler and Cyrill Rohrbach and Timo Kehrer and Sebastiano Panichella}, title = {SensoDat: Simulation-based Sensor Dataset of Self-driving Cars}, booktitle = {21th {IEEE/ACM} International Conference on Mining Software Repositories, {MSR} 2024, Lisbon, Portugal, April 15-16, 2024}, year = {2024}, doi = {to appear}, }

@article{sensodat-preprint, author = {Christian Birchler and Cyrill Rohrbach and Timo Kehrer and Sebastiano Panichella}, title = {SensoDat: Simulation-based Sensor Dataset of Self-driving Cars}, journal = {CoRR}, volume = {abs/2401.09808}, year = {2024}, url = {https://doi.org/10.48550/arXiv.2401.09808}, doi = {10.48550/ARXIV.2401.09808}, eprinttype = {arXiv}, eprint = {2401.09808}, } ```

Requirements

You need to have Docker installed and running.

NOTE: The following instructions were tested with Windows and Linux with 32GB RAM.

Automatic setup

To set up a MongoDB with the SDC simulation data, ensure Docker is up and running. Then simply execute the setup.sh (Linux/MacOS) or setup.bat (Windows) script.

Automatic clean up

To tear down the database simply execute the cleanup.sh (Linux/MacOS) or cleanup.bat (Windows) script.

Manual setup

Run the following commands in the exact order to setup the database:

Start an uploader and a mongo container: docker compose -f ./environment/docker-compose.yml up -d --build

Verify the containers are up and running: docker ps

Copy the data to the uploader container: docker cp ./data uploader:/app/data

Unzip the data in the uploader container: docker exec uploader unzip ./data/data.zip -d ./data

Copy the code to upload the data to the mongo container: docker cp ./code uploader:/app/code

Upload the data to the mongo container: docker exec -it uploader python ./code/fill_mongodb.py

To tear down the database when you don't need it anymore: docker compose -f ./environment/docker-compose.yml up down

License

```{text} SensoDat: Simulation-based Sensor Dataset of Self-driving Cars Copyright (C) 2024 Christian Birchler

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

```