News: Technical report on ArXiv.

Documentation: https://mmdetection.readthedocs.io/

I. Quick-start on VNC (based on example-annos)

1) Open the existed Anaconda-env:

source activate open-mmlab

2.1). Train from the pre-saved images and annotations in the path ./mmdetection/data/CocoCust:

├── mmdetection
    |── data
        ├── CocoCust
            └── annotations
            └── coco
            └── fakeKitti

python tools/train.py configs/fcos/fcos_r50_caffe_fpn_gn-head_1x_coco_cust.py --gpus 1 --work-dir ./fcos_r50_fpn_gn_coco_cust

2.2). Train from the pre-saved annotations and load images from other paths:

├── mmdetection
    |── data
        ├── CocoCust
            └── annotations

python tools/train.py configs/fcos/fcos_r50_caffe_fpn_gn-head_1x_coco_cust_loadFromSeparatedFile.py --gpus 1 --work-dir ./fcos_r50_fpn_gn_coco_cust

Here, the example-data already exists in this repo.

Note 1.: As an example, train2017 is same to val2017 which will indicate how the model overfit our training-data.

        2.: Here, 'workers_per_gpu' was set to 0. If more workers were set, if will occurs an out of shared memory ERROR due to a docker environment configuretion.

3) Visualization in Tensorboard:

tensorboard --logdir=./fcos_r50_fpn_gn_coco_cust/tf_logs/ --bind_all

4) Visualize the training progress:

http://127.0.0.1:6006/

II. Quick-start on Pinky (based on example-annos)

1) Attch to the existed docker container:

docker attach mmdetection

2) Other steps are same as on VNC:

Note: As an example, train2017 is same to val2017 which will indicate how the model overfit our training-data.

III.Below are mmdetection-toolbox Installation from official repo.

Installation

Please refer to get_started.md for installation.

Getting Started

Please see get_started.md for the basic usage of MMDetection. We provide colab tutorial, and full guidance for quick run with existing dataset and with new dataset for beginners. There are also tutorials for finetuning models, adding new dataset, designing data pipeline, customizing models, customizing runtime settings and useful tools.

Please refer to FAQ for frequently asked questions.

Acknowledgement

This toolbox is modified from MMdetection. If you use this toolbox or benchmark in your research, please cite the following information.

@article{mmdetection,
  title   = {{MMDetection}: Open MMLab Detection Toolbox and Benchmark},
  author  = {Chen, Kai and Wang, Jiaqi and Pang, Jiangmiao and Cao, Yuhang and
             Xiong, Yu and Li, Xiaoxiao and Sun, Shuyang and Feng, Wansen and
             Liu, Ziwei and Xu, Jiarui and Zhang, Zheng and Cheng, Dazhi and
             Zhu, Chenchen and Cheng, Tianheng and Zhao, Qijie and Li, Buyu and
             Lu, Xin and Zhu, Rui and Wu, Yue and Dai, Jifeng and Wang, Jingdong
             and Shi, Jianping and Ouyang, Wanli and Loy, Chen Change and Lin, Dahua},
  journal= {arXiv preprint arXiv:1906.07155},
  year={2019}
}