Sign inSign up

autodriveecosystem/autodrive_f1tenth_sim

By autodriveecosystem

Updated almost 2 years ago

Docker Image for AutoDRIVE Simulator used in F1TENTH Sim-Racing Competition.

Image
Languages & frameworks
Integration & delivery
1

2.1K

autodriveecosystem/autodrive_f1tenth_sim repository overview

F1TENTH Digital Twin Autonomous Sim-Racing League using AutoDRIVE Ecosystem

Github Stars Github Forks Github Downloads Sim Docker Stars Sim Docker Pulls API Docker Stars API Docker Pulls

Note:

The setup has been only tested on the Ubuntu operating system.

It is assumed that Docker is installed.

It is assumed that if the Docker container is to take advantage of an NVIDIA GPU, the host machine has been properly configured by installing the necessary NVIDIA GPU drivers and the NVIDIA Container Toolkit.

You will need the AutoDRIVE Devkit image to work with this AutoDRIVE Simulator image.

Pull AutoDRIVE Simulator Container:

docker pull autodriveecosystem/autodrive_f1tenth_sim:<TAG>

Run AutoDRIVE Simulator Container:

  1. Enable display forwarding:

    xhost local:root
    
  2. Run the container at entrypoint:

    docker run --name autodrive_f1tenth_sim --rm -it --entrypoint /bin/bash --network=host --ipc=host -v /tmp/.X11-unix:/tmp/.X11-unix:rw --env DISPLAY --privileged --gpus all autodriveecosystem/autodrive_f1tenth_sim:<TAG>
    
  3. Launch AutoDRIVE Simulator in gui mode (camera rendering will be enabled):

    ./AutoDRIVE\ Simulator.x86_64
    
  4. Launch AutoDRIVE Simulator in headless mode (camera rendering will be disabled):

    ./AutoDRIVE\ Simulator.x86_64 -batchmode -nographics -ip 127.0.0.1 -port 4567
    
  5. Start additional bash session(s) within the container (each in a new terminal window):

    docker exec -it autodrive_f1tenth_sim bash
    

Citation:

We encourage you to read and cite the following papers if you use any part of the competition framework for your research:

AutoDRIVE: A Comprehensive, Flexible and Integrated Digital Twin Ecosystem for Enhancing Autonomous Driving Research and Education
@article{AutoDRIVE-Ecosystem-2023,
author = {Samak, Tanmay and Samak, Chinmay and Kandhasamy, Sivanathan and Krovi, Venkat and Xie, Ming},
title = {AutoDRIVE: A Comprehensive, Flexible and Integrated Digital Twin Ecosystem for Autonomous Driving Research & Education},
journal = {Robotics},
volume = {12},
year = {2023},
number = {3},
article-number = {77},
url = {https://www.mdpi.com/2218-6581/12/3/77},
issn = {2218-6581},
doi = {10.3390/robotics12030077}
}

This work has been published in MDPI Robotics. The open-access publication can be found on MDPI.

AutoDRIVE Simulator: A Simulator for Scaled Autonomous Vehicle Research and Education
@inproceedings{AutoDRIVE-Simulator-2021,
author = {Samak, Tanmay Vilas and Samak, Chinmay Vilas and Xie, Ming},
title = {AutoDRIVE Simulator: A Simulator for Scaled Autonomous Vehicle Research and Education},
year = {2021},
isbn = {9781450390453},
publisher = {Association for Computing Machinery},
address = {New York, NY, USA},
url = {https://doi.org/10.1145/3483845.3483846},
doi = {10.1145/3483845.3483846},
booktitle = {2021 2nd International Conference on Control, Robotics and Intelligent System},
pages = {1–5},
numpages = {5},
location = {Qingdao, China},
series = {CCRIS'21}
}

This work has been published at 2021 International Conference on Control, Robotics and Intelligent System (CCRIS). The publication can be found on ACM Digital Library.

Tag summary

Content type

Image

Digest

sha256:e0b511807

Size

735 MB

Last updated

almost 2 years ago

docker pull autodriveecosystem/autodrive_f1tenth_sim:2024-cdc-compete