News: We released the codebase v0.1.0.
Documentation: https://mmdetection3d.readthedocs.io/
Introduction
The master branch works with PyTorch 1.3 to 1.5.
MMDetection3D is an open source object detection toolbox based on PyTorch, towards the next generation toolbox for general 3D detection. It is a part of the OpenMMLab project developed by MMLab.
Major features
-
Support multi-modality/single-modality detectors out of box
The toolbox directly supports multi-modality/single-modality detectors including MVXNet, VoteNet, PointPillars, etc.
-
Support indoor/outdoor 3D detection out of box
The toolbox directly supports popular indoor and outdoor 3D detection datasets, including ScanNet, SUNRGB-D, nuScenes, Lyft, and KITTI.
-
Natural integration with 2D detection All the about 300 models, 40+ papers, and modules supported in MMDetection's model zoo can be trained or used in this codebase.
-
High efficiency
The training and testing speed is faster than other codebases.
Apart from MMDetection3D, we also released a library MMDetection and mmcv for computer vision research, which are heavily depended on by this toolbox.
License
This project is released under the Apache 2.0 license.
Changelog
v0.1.0 was released in 8/7/2020. Please refer to changelog.md for details and release history.
Benchmark and model zoo
Supported methods and backbones are shown in the below table. Results and models are available in the model zoo.
| ResNet | ResNeXt | SENet | PointNet++ | HRNet | RegNetX | Res2Net | |
|---|---|---|---|---|---|---|---|
| SECOND | ☐ | ☐ | ☐ | ✗ | ☐ | ✓ | ☐ |
| PointPillars | ☐ | ☐ | ☐ | ✗ | ☐ | ✓ | ☐ |
| FreeAnchor | ☐ | ☐ | ☐ | ✗ | ☐ | ✓ | ☐ |
| VoteNet | ✗ | ✗ | ✗ | ✓ | ✗ | ✗ | ✗ |
| Part-A2 | ☐ | ☐ | ☐ | ✗ | ☐ | ✓ | ☐ |
| MVXNet | ☐ | ☐ | ☐ | ✗ | ☐ | ✓ | ☐ |
Other features
Note: All the about 300 models, 40+ papers, and modules supported in MMDetection's model zoo can be trained or used in this codebase.
Installation
Please refer to install.md for installation and dataset preparation.
Get Started
Please see getting_started.md for the basic usage of MMDetection. There are also tutorials for finetuning models, adding new dataset, designing data pipeline, and adding new modules.
Contributing
We appreciate all contributions to improve MMDetection3D. Please refer to CONTRIBUTING.md for the contributing guideline.
Acknowledgement
MMDetection3D is an open source project that is contributed by researchers and engineers from various colleges and companies. We appreciate all the contributors as well as users who give valuable feedbacks. We wish that the toolbox and benchmark could serve the growing research community by providing a flexible toolkit to reimplement existing methods and develop their own new 3D detectors.
Citation
If you use this toolbox or benchmark in your research, please cite this project.
@misc{mmdetection3d_2020,
title = {{MMDetection3D}},
author = {Zhang, Wenwei and Wu, Yuefeng and Wang, Tai and Li, Yinhao and
Lin, Kwan-Yee and Wang, Zhe and Shi, Jianping and Qian, Chen and
Chen, Kai, and Lin, Dahua and Loy, Chen Change},
howpublished = {\url{https://github.com/open-mmlab/mmdetection3d}},
year = {2020}
}Contact
This repo is currently maintained by Wenwei Zhang (@ZwwWayne), Yuefeng Wu (@xavierwu95), Tai Wang (@Tai-Wang), and Yinhao Li (@yinchimaoliang).