DynamicRouting

This project provides an implementation for "Learning Dynamic Routing for Semantic Segmentation" (CVPR2020 Oral) on PyTorch. For the reason that experiments in the paper were conducted using internal framework, this project reimplements them on dl_lib and reports detailed comparisons below. Some parts of code in dl_lib are based on detectron2.

Requirement

• Python >= 3.6
  • python3 --version
• PyTorch >= 1.3
  • pip3 install torch torchvision
• OpenCV
  • pip3 install opencv-python
• GCC >= 4.9
  • gcc --version

Installation

Make sure that your get at least one gpu when compiling. Run:

• git clone https://github.com/yanwei-li/DynamicRouting.git
• cd DynamicRouting
• sudo python3 setup.py build develop

Usage

Dataset

We use Cityscapes dataset for training and validation. Please refer to datasets/README.md or dataset structure in detectron2 for more details.

• Cityscapes Download

Pretrained Model

We give ImageNet pretained models:

• Layer16-Fix GoogleDrive
• Layer33-Fix GoogleDrive

Training

For example, if you want to train Dynamic Network with Layer16 backbone:

• Train from scratch

  cd playground/Dynamic/Seg.Layer16
  dl_train --num-gpus 4

• Use ImageNet pretrain

  cd playground/Dynamic/Seg.Layer16.ImageNet
  dl_train --num-gpus 4 MODEL.WEIGHTS /path/to/your/save_dir/ckpt.pth

NOTE: Please set FIX_SIZE_FOR_FLOPS to [768,768] and [1024,2048] for training and evaluation, respectively.

Evaluation

You can evaluate the trained or downloaded model:

• Evaluate the trained model

  dl_test --num-gpus 8

• Evaluate the downloaded model:

  dl_test --num-gpus 8 MODEL.WEIGHTS /path/to/your/save_dir/ckpt.pth 

NOTE: If your machine does not support such setting, please change settings in config.py to a suitable value.

Performance

Cityscapes val set

Without ImageNet Pretrain:

With ImageNet Pretrain:

To do

• Faster inference speed
• Support more vision tasks
  • Object detection
  • Instance segmentation
  • Panoptic segmentation

Acknowledgement

• Detectron2
• DARTS

Citation

Consider cite the Dynamic Routing in your publications if it helps your research.

@inproceedings{li2020learning,
    title = {Learning Dynamic Routing for Semantic Segmentation},
    author = {Yanwei Li, Lin Song, Yukang Chen, Zeming Li, Xiangyu Zhang, Xingang Wang, Jian Sun},
    booktitle = {IEEE Conference on Computer Vision and Pattern Recognition},
    year = {2020}
}

Consider cite this project in your publications if it helps your research.

@misc{DynamicRouting,
    author = {Yanwei Li},
    title = {DynamicRouting},
    howpublished = {\url{https://github.com/yanwei-li/DynamicRouting}},
    year ={2020}
}