https://github.com/amazon-science/bigdetection
BigDetection: A Large-scale Benchmark for Improved Object Detector Pre-training
Science Score: 23.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
○.zenodo.json file
-
○DOI references
-
✓Academic publication links
Links to: arxiv.org -
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (8.4%) to scientific vocabulary
Keywords
Keywords from Contributors
Repository
BigDetection: A Large-scale Benchmark for Improved Object Detector Pre-training
Basic Info
Statistics
- Stars: 395
- Watchers: 8
- Forks: 25
- Open Issues: 5
- Releases: 0
Topics
Metadata Files
README.md
BigDetection: A Large-scale Benchmark for Improved Object Detector Pre-training
By Likun Cai, Zhi Zhang, Yi Zhu, Li Zhang, Mu Li, Xiangyang Xue.

This repo is the official implementation of BigDetection. It is based on mmdetection and CBNetV2.
Introduction
We construct a new large-scale benchmark termed BigDetection. Our goal is to simply leverage the training data from existing datasets (LVIS, OpenImages and Object365) with carefully designed principles, and curate a larger dataset for improved detector pre-training. BigDetection dataset has 600 object categories and contains 3.4M training images with 36M object bounding boxes. We show some important statistics of BigDetection in the following figure.
Left: Number of images per category of BigDetection. Right: Number of instances in different object sizes.
Results and Models
BigDetection Validation
We show the evaluation results on BigDetection Validation. We hope BigDetection could serve as a new challenging benchmark for evaluating next-level object detection methods.
| Method | mAP (bigdet val) | Links | | --- | :---: | :---: | | YOLOv3 | 9.7 | model/config | | Deformable DETR | 13.1 | model/config | | Faster R-CNN (C4)* | 18.9 | model | | Faster R-CNN (FPN)* | 19.4 | model | | CenterNet2* | 23.1 | model | | Cascade R-CNN* | 24.1 | model | | CBNetV2-Swin-Base | 35.1 | model/config |
COCO Validation
We show the finetuning performance on COCO minival/test-dev. Results show that BigDetection pre-training provides significant benefits for different detector architectures. We achieve 59.8 mAP on COCO test-dev with a single model.
| Method | mAP (coco minival/test-dev) | Links | | --- | :---: | :---: | | YOLOv3 | 30.5/- | config | | Deformable DETR | 39.9/- | model/config | | Faster R-CNN (C4)* | 38.8/- | model | | Faster R-CNN (FPN)* | 40.5/- | model | | CenterNet2* | 45.3/- | model | | Cascade R-CNN* | 45.1/- | model | | CBNetV2-Swin-Base | 59.1/59.5 | model/config | | CBNetV2-Swin-Base (TTA) | 59.5/59.8 | config |
Data Efficiency
We followed STAC and SoftTeacher to evaluate on COCO for different partial annotation settings.
| Method | mAP (1%) | mAP (2%) | mAP (5%) | mAP (10%) | | --- | :---: | :---: | :---: | :---: | | Baseline | 9.8 | 14.3 | 21.2 | 26.2 | | STAC | 14.0 | 18.3 | 24.4 | 28.6 | | SoftTeacher (ICCV 21) | 20.5 | 26.5 | 30.7 | 34.0 | | Ours | 25.3 | 28.1 | 31.9 | 34.1 | | | model | model | model | model |
Notes
- The models following
*are implemented on another detection codebase Detectron2. Here we provide the pretrained checkpoints. The results can be reproduced following the installation of CenterNet2 codebase. - Most of models are trained for
8Xschedule on BigDetection. - Most of pretrained models are finetuned for
1Xschedule on COCO. TTAdenotes test time augmentation.- Pre-trained models of Swin Transformer can be downloaded from Swin Transformer for ImageNet Classification.
Getting Started
Requirements
Ubuntu 16.04CUDA 10.2
Installation
```
Create conda environment
conda create -n bigdet python=3.7 -y conda activate bigdet
Install Pytorch
conda install pytorch==1.8.0 torchvision==0.9.0 cudatoolkit=10.2 -c pytorch
Install mmcv
pip install mmcv-full==1.3.9 -f https://download.openmmlab.com/mmcv/dist/cu102/torch1.8.0/index.html
Clone and install
git clone https://github.com/amazon-research/bigdetection.git cd bigdetection pip install -r requirements/build.txt pip install -v -e .
Install Apex (optinal)
git clone https://github.com/NVIDIA/apex cd apex pip install -v --disable-pip-version-check --no-cache-dir --global-option="--cppext" --global-option="--cudaext" ./ ```
Data Preparation
Our BigDetection involves 3 datasets and train/val data can be downloaded from their official website (Objects365, OpenImages v6, LVIS v1.0). All datasets should be placed under $bigdetection/data/ as below. The synsets (total 600 class names) of BigDetection dataset can be downloaded here: bigdetection_synsets. Contact us with lkcai20@fudan.edu.cn to get access to our pre-processed annotation files.
bigdetection/data
└── BigDetection
├── annotations
│ ├── bigdet_obj_train.json
│ ├── bigdet_oid_train.json
│ ├── bigdet_lvis_train.json
│ ├── bigdet_val.json
│ └── cas_weights.json
├── train
│ ├── Objects365
│ ├── OpenImages
│ └── LVIS
└── val
Training
To train a detector with pre-trained models, run: ```
multi-gpu training
tools/disttrain.sh <CONFIGFILE>
Pre-training
To pre-train a CBNetV2 with a Swin-Base backbone on BigDetection using 8 GPUs, run: (PRETRAIN_MODEL should be pre-trained checkpoint of Base-Swin-Transformer: model)
tools/dist_train.sh configs/BigDetection/cbnetv2/htc_cbv2_swin_base_giou_4conv1f_adamw_bigdet.py 8 \
--cfg-options load_from=<PRETRAIN_MODEL>
To pre-train a Deformable-DETR with a ResNet-50 backbone on BigDetection, run:
tools/dist_train.sh configs/BigDetection/deformable_detr/deformable_detr_r50_16x2_8x_bigdet.py 8
Fine-tuning
To fine-tune a BigDetection pre-trained CBNetV2 (with Swin-Base backbone) on COCO, run: (PRETRAIN_MODEL should be BigDetection pre-trained checkpoint of CBNetV2: model)
tools/dist_train.sh configs/BigDetection/cbnetv2/htc_cbv2_swin_base_giou_4conv1f_adamw_20e_coco.py 8 \
--cfg-options load_from=<PRETRAIN_MODEL>
Inference
To evaluate a detector with pre-trained checkpoints, run:
tools/dist_test.sh <CONFIG_FILE> <CHECKPOINT> <GPU_NUM> --eval bbox
BigDetection evaluation
To evaluate pre-trained CBNetV2 on BigDetection validation, run:
tools/dist_test.sh configs/BigDetection/cbnetv2/htc_cbv2_swin_base_giou_4conv1f_adamw_bigdet.py \
<BIGDET_PRETRAIN_CHECKPOINT> 8 --eval bbox
COCO evaluation
To evaluate COCO-finetuned CBNetV2 on COCO validation, run: ```
without test-time-augmentation
tools/disttest.sh configs/BigDetection/cbnetv2/htccbv2swinbasegiou4conv1fadamw20ecoco.py \ <COCOFINETUNE_CHECKPOINT> 8 --eval bbox mask
with test-time-augmentation
tools/disttest.sh configs/BigDetection/cbnetv2/htccbv2swinbasegiou4conv1fadamw20ecocotta.py \
Other configuration based on Detectron2 can be found at detectron2-probject.
Citation
If you use our dataset or pretrained models in your research, please kindly consider to cite the following paper.
@article{bigdetection2022,
title={BigDetection: A Large-scale Benchmark for Improved Object Detector Pre-training},
author={Likun Cai and Zhi Zhang and Yi Zhu and Li Zhang and Mu Li and Xiangyang Xue},
journal={arXiv preprint arXiv:2203.13249},
year={2022}
}
Security
See CONTRIBUTING for more information.
License
This project is licensed under the Apache-2.0 License.
Acknowledgement
We thank the authors releasing mmdetection and CBNetv2 for object detection research community.
Owner
- Name: Amazon Science
- Login: amazon-science
- Kind: organization
- Website: https://amazon.science
- Twitter: AmazonScience
- Repositories: 80
- Profile: https://github.com/amazon-science
GitHub Events
Total
- Issues event: 1
- Watch event: 9
- Pull request event: 1
- Create event: 1
Last Year
- Issues event: 1
- Watch event: 9
- Pull request event: 1
- Create event: 1
Committers
Last synced: 9 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| cailk | c****7@g****m | 20 |
| bryanzhu | y****9@g****m | 2 |
| dependabot[bot] | 4****] | 1 |
| Amazon GitHub Automation | 5****o | 1 |
Issues and Pull Requests
Last synced: 9 months ago
All Time
- Total issues: 17
- Total pull requests: 15
- Average time to close issues: about 2 months
- Average time to close pull requests: 5 days
- Total issue authors: 10
- Total pull request authors: 4
- Average comments per issue: 2.24
- Average comments per pull request: 0.27
- Merged pull requests: 10
- Bot issues: 0
- Bot pull requests: 4
Past Year
- Issues: 2
- Pull requests: 2
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 1
- Pull request authors: 1
- Average comments per issue: 0.0
- Average comments per pull request: 0.0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 2
Top Authors
Issue Authors
- luohao136486939 (1)
- zys1994 (1)
- dzhurak (1)
- JarvisKevin (1)
- AK391 (1)
- Kenneth-X (1)
- liming-ai (1)
- titusss (1)
- YangYangGirl (1)
- moontsar (1)
- czczup (1)
Pull Request Authors
- cailk (5)
- dependabot[bot] (3)
- bryanyzhu (2)
- JY-Qiao (2)
Top Labels
Issue Labels
Pull Request Labels
Dependencies
- cython *
- numpy *
- recommonmark *
- sphinx *
- sphinx_markdown_tables *
- sphinx_rtd_theme *
- mmcv-full >=1.3.3
- albumentations >=0.3.2
- cityscapesscripts *
- imagecorruptions *
- scipy *
- sklearn *
- mmcv *
- torch *
- torchvision *
- matplotlib *
- numpy *
- pycocotools *
- pycocotools-windows *
- six *
- terminaltables *
- timm *
- asynctest *
- codecov *
- flake8 *
- interrogate *
- isort ==4.3.21
- kwarray *
- onnx ==1.7.0
- onnxruntime ==1.5.1
- pytest *
- ubelt *
- xdoctest >=0.10.0
- yapf *