nuPlan

The world's first benchmark for autonomous vehicle planning.

---

Website • Download • Citation
Changelog • Structure
Setup • Tutorial

---

---

Planning challenges

Stay tuned for the upcoming nuPlan ML planning challenges!

---

Changelog

• Jul 15 2022
  • v0.3 Devkit: Updates to the devit including but not limited to: nuBoard update, reduce RAM usage during caching and training, new map APIs, simulation and metrics runtime improvements.
• Jun 10 2022
  • v1.0 Dataset: Full nuPlan dataset release with over 1,300 hours of driving data (15,000+ logs) across 4 cities (Las Vegas, Pittsburgh, Boston, Singapore).
  • v0.2 Devkit: Multiple devkit updates with improvements across the whole framework (planning models, training, simulation, metrics, dashboard, tutorials and more).
• Dec 19 2021
  • v0.2 Dataset: Fixed bugs in the teaser nuPlan dataset.
• Dec 10 2021
  • v0.1 Dataset: Initial teaser nuPlan dataset release with over 200 hours of driving data (350+ logs) across Las Vegas.
  • v0.1 Devkit: Initial nuPlan devkit release.

---

Devkit and dataset setup

Please refer to the installation page for detailed instructions on how to setup the devkit.

Please refer to the dataset page for detailed instructions on how to download and setup the dataset.

---

Getting started

Please follow these steps to make yourself familiar with the nuPlan dataset:

• Familiarize yourself with the main features of nuPlan and the dataset description.

• Setup the devkit and dataset as described above.

• Walk through the tutorials in this folder or run them yourself using jupyter notebook ~/nuplan-devkit/tutorials/<filename>.ipynb and replacing <filename> with the tutorial's name. The following tutorials are available:

  • nuplan_framework.ipynb: Main tutorial for anyone who wants to dive right into ML planning. It describes how to 1) train an ML planner, 2) simulate it, 3) measure the performance and 4) visualize the results.
  • nuplan_scenario_visualization.ipynb: Tutorial for visualizing various scenario types contained within the nuPlan dataset (e.g. unprotected turns, lane changes, interactions with pedestrians and more).
  • nuplan_planner_tutorial.ipynb: Tutorial with instructions on how to develop and simulate a planner from scratch within the nuPlan framework.

• Familiarize yourself with the nuPlan CLI, which gets installed by installing the devkit using pip (editable and not) by running:

  nuplan_cli --help
  nuplan_cli COMMAND --help
  

• Read the nuPlan paper to understand the details behind the dataset.

---

Devkit structure

Our code is organized in these directories:

nuplan_devkit
├── ci              - Continuous integration code - not relevant for average users.
├── docs            - Readmes and other documentation of the repo and dataset.
├── nuplan          - The main source folder.
│   ├── common      - Code shared by "database" and "planning".
│   ├── database    - The core devkit used to load and render nuPlan dataset and maps.
│   └── planning    - The stand-alone planning framework for simulation, training and evaluation.
│   └── cli         - Command line interface tools for the nuPlan database.
└── tutorials       - Interactive tutorials, see "Getting started".

---

Citation

Please use the following citation when referencing nuPlan:

@INPROCEEDINGS{nuplan, 
  title={NuPlan: A closed-loop ML-based planning benchmark for autonomous vehicles},
  author={H. Caesar, J. Kabzan, K. Tan et al.,},
  booktitle={CVPR ADP3 workshop},
  year=2021
}