Quick start CARLA examples

Quick start CARLA examples

Load, run, get results and compare an example robot brain in CARLA

Quick start CARLA examples

Installation

Installation

Use the software tool for comparing autonomous driving solutions. Install Behavior Metrics

Installation

Documentation

Documentation

More information about the project architecture. References used, guides, articles, etc.

Documentation

We are always open for new contributions from outside developers. If you want to contribute to this project, please visit the CONTRIBUTING guide

This software tool provides evaluation capabilities for autonomous driving solutions using simulation. We provide a series of quantitative metrics for the evaluation of autonomous driving solutions with support for two simulators, CARLA (main supported simulator) and gazebo (partial support). Currently supported tasks include:

  • Follow-lane
  • Driving in traffic
  • Navigation

Each task comes with its own custom evaluation metrics that can help compare autonomous driving solutions. The main component of the ego vehicle is the brain, which receives sensor data, manipulates it, and generates robot control commands based on it. The inner part of the brain can be controlled by an end-to-end model, written in Tensorflow or PyTorch, a reinforcement learning policy, or even an explicitly programmed policy.

The software provides two main pipelines, a graphical user interface (GUI) and a headless mode (scripted). The first one is intended for testing one brain+model at a time and debugging it visually while the headless mode is intended for running lots of experiments at the same time for comparison of a batch of brain+models in different scenarios.

Installation

For more information about the installation, go to this link.

Examples

config

Citation

Check out the paper website.

If you find our repo useful, please cite us as:

@article{PANIEGO2024101702,
title = {Behavior metrics: An open-source assessment tool for autonomous driving tasks},
journal = {SoftwareX},
volume = {26},
pages = {101702},
year = {2024},
issn = {2352-7110},
doi = {https://doi.org/10.1016/j.softx.2024.101702},
url = {https://www.sciencedirect.com/science/article/pii/S2352711024000736},
author = {Sergio Paniego and Roberto Calvo-Palomino and JoséMaría Cañas},
keywords = {Evaluation tool, Autonomous driving, Imitation learning},
abstract = {The development and validation of autonomous driving solutions require testing broadly in simulation. Addressing this requirement, we present Behavior Metrics (BM) for the quantitative and qualitative assessment and comparison of solutions for the main autonomous driving tasks. This software provides two evaluation pipelines, one with a graphical user interface used for qualitative assessment and the other headless for massive and unattended tests and benchmarks. It generates a series of quantitative metrics complementary to the simulator’s, including fine-grained metrics for each particular driving task (lane following, driving in traffic, route navigation, etc.). It provides a deeper and broader understanding of the solutions’ performance and allows their comparison and improvement. It uses and supports state-of-the-art open software such as the reference CARLA simulator, the ROS robotics middleware, PyTorch, and TensorFlow deep learning frameworks. BehaviorMetrics is available open-source for the community.}
}

You can see the project status in the GitHub repository here.