pytorch-mask-rcnn

A pytorch implementation of Mask RCNN detection framework based on

• endernewton/tf-faster-rcnn, developed based on TensorFlow + Numpy

• ruotianluo/pytorch-faster-rcnn, developed based on Pytorch + Numpy

This project supports single-GPU training of ResNet101-based Mask R-CNN (without FPN support). The purpose is to support the experiments in MAttNet, whose REFER dataset is a subset of COCO training portion. Thus our pre-trained model takes COCO_2014_train_minus_refer_valtest + COCO_2014_valminusminival images for training.

Prerequisites

• Python 2.7

• Pytorch 0.2 or higher

• CUDA 8.0 or higher

• requirements.txt

Preparation

1. First of all, clone the code with refer API:

git clone --recursive https://github.com/lichengunc/mask-faster-rcnn

2. Prepare data:

• COCO: We use coco to name COCO's API as inheritance. Download the annotations and images into data/coco. Note the valminusminival and minival can be downloaded here.

git clone https://github.com/cocodataset/cocoapi data/coco

• REFER: Follow the instructions in REFER to prepare the annotations for RefCOCO, RefCOCO+ and RefCOCOg.

git clone https://github.com/lichengunc/refer data/refer

• ImageNet Weights: Find the resnet101-caffe download link from this repository, and download it as data/imagenet_weights/res101.pth.

• coco_minus_refer: Make the coco_minus_refer annotation, which is to be saved as data/coco/annotations/instances_train_minus_refer_valtest2014.json

python tools/make_coco_minus_refer_instances.py

Compilation

As pointed out by ruotianluo/pytorch-faster-rcnn, choose the right -arch to compile the cuda code:

Compile the CUDA-based nms and roi_pooling using following simple commands:

cd lib
make

Training

Run by (notime as extra/tag)

./experiments/scripts/train_mask_rcnn_notime.sh 0 refcoco res101 notime

• Train on COCO 2014 trainval35k minus refer_valtest, and test on minival (800k/1250k), 35.8 on detection and 30.7 on segmentation (nms).

Checking the training process by calling tensorboard, and check it at server.cs.unc.edu:port_number

tensorboard --logdir tensorboard/res101 --port=port_number

Evaluation

Run by (notime as extra/tag)

./experiments/scripts/test_mask_rcnn_notime.sh 0 refcoco res101 notime

Detection Comparison:

• Compared with Faster R-CNN trained/evaluated on the same images.

Segmentation Comparison:

• We compare with Mask R-CNN implementation. Note this comparison is slightly unfair to ours, due to

• We have fewer (~6,500) training images.

• Our training is single GPU.

• The shorter border length in our model is 600px instead of 800px.

Pretrained Model

We provide the model we used in MAttNet for mask comprehension.

• res101-notime-1250k: UNC Server

Download and put the downloaded .pth and .pkl files into output/res101/coco_2014_train_minus_refer_valtest+coco_2014_valminusminival/notime

Demo

• Follow the ipython notebook of test/check_model.ipynb to test our model.