Awesome

About

Robo3D is an evaluation suite heading toward robust and reliable 3D perception in autonomous driving. With it, we probe the robustness of 3D detectors and segmentors under out-of-distribution (OoD) scenarios against corruptions that occur in the real-world environment. Specifically, we consider natural corruptions happen in the following cases:

1. Adverse weather conditions, such as fog, wet ground, and snow;
2. External disturbances that are caused by motion blur or result in LiDAR beam missing;
3. Internal sensor failure, including crosstalk, possible incomplete echo, and cross-sensor scenarios.

Visit our project page to explore more examples. :oncoming_automobile:

Updates

• [2024.05] - Check out the technical report of this competition: The RoboDrive Challenge: Drive Anytime Anywhere in Any Condition :blue_car:.
• [2024.05] - The slides of the 2024 RoboDrive Workshop are available here :arrow_heading_up:.
• [2024.05] - The video recordings are available on YouTube :arrow_heading_up: and Bilibili :arrow_heading_up:.
• [2024.05] - We are glad to announce the winning teams of the 2024 RoboDrive Challenge:
  • Track 1: Robust BEV Detection
    • :1st_place_medal: DeepVision, :2nd_place_medal: Ponyville Autonauts Ltd, :3rd_place_medal: CyberBEV
  • Track 2: Robust Map Segmentation
    • :1st_place_medal: SafeDrive-SSR, :2nd_place_medal: CrazyFriday, :3rd_place_medal: Samsung Research
  • Track 3: Robust Occupancy Prediction
    • :1st_place_medal: ViewFormer, :2nd_place_medal: APEC Blue, :3rd_place_medal: hm.unilab
  • Track 4: Robust Depth Estimation
    • :1st_place_medal: HIT-AIIA, :2nd_place_medal: BUAA-Trans, :3rd_place_medal: CUSTZS
  • Track 5: Robust Multi-Modal BEV Detection
    • :1st_place_medal: safedrive-promax, :2nd_place_medal: Ponyville Autonauts Ltd, :3rd_place_medal: HITSZrobodrive
• [2024.01] - The toolkit tailored for the 2024 RoboDrive Challenge has been released. :hammer_and_wrench:
• [2023.12] - We are hosting the RoboDrive Challenge at ICRA 2024. :blue_car:
• [2023.09] - Intend to improve the OoD robustness of your 3D perception models? Check out our recent work, Seal :seal:, an image-to-LiDAR self-supervised pretraining framework that leverages off-the-shelf knowledge from vision foundation models for cross-modality representation learning.
• [2023.07] - Robo3D was accepted to ICCV 2023! :tada:
• [2023.03] - We establish "Robust 3D Perception" leaderboards on Paper-with-Code: ¹KITTI-C, ²SemanticKITTI-C, ³nuScenes-C, and ⁴WOD-C. Join the challenge today! :raising_hand:
• [2023.03] - The KITTI-C, SemanticKITTI-C, and nuScenes-C datasets are ready for download at the OpenDataLab platform. Kindly refer to this page for more details on preparing these datasets. :beers:
• [2023.01] - Launch of the Robo3D benchmark. In this initial version, we include 12 detectors and 22 segmentors, evaluated on 4 large-scale autonomous driving datasets (KITTI, SemanticKITTI, nuScenes, and Waymo Open) with 8 corruption types across 3 severity levels.

Outline

• Taxonomy
• Video Demo
• Installation
• Data Preparation
• Getting Started
• Model Zoo
• Benchmark
• Create Corruption Set
• TODO List
• Citation
• License
• Acknowledgements

Taxonomy

Video Demo

Installation

For details related to installation, kindly refer to INSTALL.md.

Data Preparation

Our datasets are hosted by OpenDataLab.

<img src="https://raw.githubusercontent.com/opendatalab/dsdl-sdk/2ae5264a7ce1ae6116720478f8fa9e59556bed41/resources/opendatalab.svg" width="32%"/><br> OpenDataLab is a pioneering open data platform for the large AI model era, making datasets accessible. By using OpenDataLab, researchers can obtain free formatted datasets in various fields.

Kindly refer to DATA_PREPARE.md for the details to prepare the ¹KITTI, ²KITTI-C, ³SemanticKITTI, ⁴SemanticKITTI-C, ⁵nuScenes, ⁶nuScenes-C, ⁷WOD, and ⁸WOD-C datasets.

Getting Started

To learn more usage about this codebase, kindly refer to GET_STARTED.md.

Model Zoo

• SqueezeSeg, ICRA 2018. ^[Code]
• SqueezeSegV2, ICRA 2019. ^[Code]
• MinkowskiNet, CVPR 2019. ^[Code]
• RangeNet++, IROS 2019. ^[Code]
• KPConv, ICCV 2019. ^[Code]
• SalsaNext, ISVC 2020. ^[Code]
• RandLA-Net, CVPR 2020. ^[Code]
• PolarNet, CVPR 2020. ^[Code]
• 3D-MiniNet, IROS 2020. ^[Code]
• SPVCNN, ECCV 2020. ^[Code]
• Cylinder3D, CVPR 2021. ^[Code]
• FIDNet, IROS 2021. ^[Code]
• RPVNet, ICCV 2021.
• CENet, ICME 2022. ^[Code]
• CPGNet, ICRA 2022. ^[Code]
• 2DPASS, ECCV 2022. ^[Code]
• GFNet, TMLR 2022. ^[Code]
• PCB-RandNet, arXiv 2022. ^[Code]
• PIDS, WACV 2023. ^[Code]
• SphereFormer, CVPR 2023. ^[Code]
• WaffleIron, ICCV 2023. ^[Code]
• FRNet, arXiv 2023. ^[Code]

• DS-Net, CVPR 2021. ^[Code]
• Panoptic-PolarNet, CVPR 2021. ^[Code]

• SECOND, Sensors 2018. ^[Code]
• PointPillars, CVPR 2019. ^[Code]
• PointRCNN, CVPR 2019. ^[Code]
• Part-A2, T-PAMI 2020.
• PV-RCNN, CVPR 2020. ^[Code]
• 3DSSD, CVPR 2020. ^[Code]
• SA-SSD, CVPR 2020. ^[Code]
• CenterPoint, CVPR 2021. ^[Code]
• PV-RCNN++, IJCV 2022. ^[Code]
• SphereFormer, CVPR 2023. ^[Code]

Benchmark

LiDAR Semantic Segmentation

The mean Intersection-over-Union (mIoU) is consistently used as the main indicator for evaluating model performance in our LiDAR semantic segmentation benchmark. The following two metrics are adopted to compare among models' robustness:

• mCE (the lower the better): The average corruption error (in percentage) of a candidate model compared to the baseline model, which is calculated among all corruption types across three severity levels.
• mRR (the higher the better): The average resilience rate (in percentage) of a candidate model compared to its "clean" performance, which is calculated among all corruption types across three severity levels.

:red_car:  SemanticKITTI-C

Note: Symbol ^:star: denotes the baseline model adopted in mCE calculation.

:blue_car:  nuScenes-C

Note: Symbol ^:star: denotes the baseline model adopted in mCE calculation.

:taxi:  WOD-C

Note: Symbol ^:star: denotes the baseline model adopted in mCE calculation.

3D Object Detection

The mean average precision (mAP) and nuScenes detection score (NDS) are consistently used as the main indicator for evaluating model performance in our LiDAR semantic segmentation benchmark. The following two metrics are adopted to compare between models' robustness:

• mCE (the lower the better): The average corruption error (in percentage) of a candidate model compared to the baseline model, which is calculated among all corruption types across three severity levels.
• mRR (the higher the better): The average resilience rate (in percentage) of a candidate model compared to its "clean" performance, which is calculated among all corruption types across three severity levels.

:red_car:  KITTI-C

Note: Symbol ^:star: denotes the baseline model adopted in mCE calculation.

:blue_car:  nuScenes-C

Note: Symbol ^:star: denotes the baseline model adopted in mCE calculation.

:taxi:  WOD-C

Note: Symbol ^:star: denotes the baseline model adopted in mCE calculation.

:vertical_traffic_light: More Benchmarking Results

For more detailed experimental results and visual comparisons, please refer to RESULTS.md.

Create Corruption Set

You can manage to create your own "Robo3D" corruption sets on other LiDAR-based point cloud datasets using our defined corruption types! Follow the instructions listed in CREATE.md.

TODO List

• Initial release. 🚀
• Add scripts for creating common corruptions.
• Add download links for corruption sets.
• Add evaluation scripts on corruption sets.
• Release checkpoints.
• ...

Citation

If you find this work helpful, please kindly consider citing our paper:

@inproceedings{kong2023robo3d,
    author = {Lingdong Kong and Youquan Liu and Xin Li and Runnan Chen and Wenwei Zhang and Jiawei Ren and Liang Pan and Kai Chen and Ziwei Liu},
    title = {Robo3D: Towards Robust and Reliable 3D Perception against Corruptions},
    booktitle = {Proceedings of the IEEE/CVF International Conference on Computer Vision (ICCV)},
    pages = {19994--20006},
    year = {2023},
}

@misc{kong2023robo3d_benchmark,
  title = {The Robo3D Benchmark for Robust and Reliable 3D Perception},
  author = {Lingdong Kong and Youquan Liu and Xin Li and Runnan Chen and Wenwei Zhang and Jiawei Ren and Liang Pan and Kai Chen and Ziwei Liu},
  howpublished = {\url{https://github.com/ldkong1205/Robo3D}},
  year = {2023},
}

License

<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/80x15.png" /></a> <br /> This work is under the <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License</a>, while some specific operations in this codebase might be with other licenses. Please refer to LICENSE.md for a more careful check, if you are using our code for commercial matters.

Acknowledgements

This work is developed based on the MMDetection3D codebase.

<img src="https://github.com/open-mmlab/mmdetection3d/blob/main/resources/mmdet3d-logo.png" width="30%"/><br> MMDetection3D is an open source object detection toolbox based on PyTorch, towards the next-generation platform for general 3D detection. It is a part of the OpenMMLab project developed by MMLab.

:heart: We thank Jiangmiao Pang and Tai Wang for their insightful discussions and feedback. We thank the OpenDataLab platform for hosting our datasets.