Skip to content

Latest commit

 

History

History
63 lines (43 loc) · 4.38 KB

README.md

File metadata and controls

63 lines (43 loc) · 4.38 KB
Raw

FCOS3D: Fully Convolutional One-Stage Monocular 3D Object Detection

Introduction

FCOS3D is a general anchor-free, one-stage monocular 3D object detector adapted from the original 2D version FCOS. It serves as a baseline built on top of mmdetection and mmdetection3d for 3D detection based on monocular vision.

Currently we first support the benchmark on the large-scale nuScenes dataset, which achieved 1st place out of all the vision-only methods in the nuScenes 3D detecton challenge of NeurIPS 2020.

@article{wang2021fcos3d,
  title={{FCOS3D}: Fully Convolutional One-Stage Monocular 3D Object Detection},
  author={Wang, Tai and Zhu, Xinge and Pang, Jiangmiao and Lin, Dahua},
  journal={arXiv preprint arXiv:2104.10956},
  year={2021}
}
# For the original 2D version
@inproceedings{tian2019fcos,
  title     =  {{FCOS}: Fully Convolutional One-Stage Object Detection},
  author    =  {Tian, Zhi and Shen, Chunhua and Chen, Hao and He, Tong},
  booktitle =  {Proc. Int. Conf. Computer Vision (ICCV)},
  year      =  {2019}
}

demo image

Usage

Data Preparation

After supporting FCOS3D and monocular 3D object detection in v0.13.0, the coco-style 2D json info files will include related annotations by default (see here if you would like to change the parameter). So you can just follow the data preparation steps given in the documentation, then all the needed infos are ready together.

Training and Inference

The way to training and inference a monocular 3D object detector is the same as others in mmdetection and mmdetection3d. You can basically follow the documentation and change the config, work_dirs, etc. accordingly.

Test time augmentation

We implement test time augmentation for the dense outputs of detection heads, which is more effective than merging predicted boxes at last. You can turn on it by setting flip=True in the test_pipeline.

Training with finetune

Due to the scale and measurements of depth is different from those of other regression targets, we first train the model with depth weight equal to 0.2 for a more stable training procedure. For a stronger detector with better performance, please finetune the model with depth weight changed to 1.0 as shown in the config. Note that the path of load_from needs to be changed to yours accordingly.

Visualizing prediction results

We also provide visualization functions to show the monocular 3D detection results. Simply follow the documentation and use the single-gpu testing command. You only need to add the --show flag and specify --show-dir to store the visualization results.

Results

NuScenes

Backbone Lr schd Mem (GB) Inf time (fps) mAP NDS Download
ResNet101 w/ DCN 1x 8.69 29.9 37.3 model | log
above w/ finetune 1x 8.69 32.1 39.3 model | log
above w/ tta 1x 8.69 33.1 40.0