nuplan-devkit
Welcome to the devkit of nuPlan.
Overview
- Changelog
- Teaser release
- Devkit structure
- Devkit setup
- Dataset setup
- Getting started
- Known issues
- Citation
Changelog
- Dec. 10, 2021: Devkit v0.1.0: Release of the initial teaser dataset (v0.1) and corresponding devkit and maps (v0.1). See Teaser release for more information.
Teaser release
On Dec. 10 2021 we released the nuPlan teaser dataset and devkit. This is meant to be a public beta version. We are aware of several limitations of the current dataset and devkit. Nevertheless we have chosen to make this teaser available to the public for early consultation and to receive feedback on how to improve it. We appreciate your feedback as a Github issue.
Note: All interfaces are subject to change for the full release! No backward compatibility can be guaranteed.
Below is a list of upcoming features for the full release:
- The teaser dataset includes 200h of data from Las Vegas, we will be releasing the full 1500h dataset that also includes data from Singapore, Boston or Pittsburgh in early 2022.
- The full release will also include the sensor data for 150h (10% of the total dataset).
- Localization, perception scenario tags and traffic lights will be improved in future releases.
- The full release will have an improved dashboard, closed-loop training, advanced planning baselines, end-to-end planners, ML smart agents, RL environment, as well as more metrics and scenarios.
Devkit structure
Our code is organized in these directories:
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.
tutorials - Interactive tutorials, see `Getting started`.
Devkit setup
Please refer to the installation page for detailed instructions on how to setup the devkit.
Dataset setup
To download nuPlan you need to go to the Download page, create an account and agree to the Terms of Use. After logging in you will see multiple archives. For the devkit to work you will need to download all archives. Please unpack the archives to the ~/nuplan/dataset
folder. Eventually you should have the following folder structure:
~/nuplan/dataset - The dataset folder. Can be read-only.
nuplan_v*.db - SQLite database that includes all metadata
maps - Folder for all map files
- Sensor data will be added in the future
~/nuplan/exp - The experiment and cache folder. Must have read and write access.
If you want to use another folder, you can set the corresponding environment variable or specify the data_root
parameter of the NuPlanDB class (see tutorial).
Getting started
Please follow these steps to make yourself familiar with the nuScenes 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/
.ipynb
Replace
- `nuplan_framework.ipynb`: This is the 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.
- Read the nuPlan paper to understand the details behind the dataset.
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
}