The Official PyTorch code for "L2G: A Simple Local-to-Global Knowledge Transfer Framework for Weakly Supervised Semantic Segmentation", which is implemented based on the code of OAA-PyTorch. The segmentation framework is borrowed from deeplab-pytorch.

Use the following command to prepare your enviroment.

pip install -r requirements.txt

Download the PASCAL VOC dataset and MS COCO dataset, respectively.

• PASCAL VOC 2012
• MS COCO 2014

L2G uses the off-the-shelf saliency maps generated from PoolNet. Download them and move to a folder named Sal.

• Saliency maps for PASCAL VOC 2012
• Saliency maps for MS COCO 2014

The data folder structure should be like:

L2G
├── models
├── scripts
├── utils
├── data
│   ├── voc12
│   │   ├── JPEGImages
│   │   ├── SegmentationClass
│   │   ├── SegmentationClassAug
│   │   ├── Sal
│   ├── coco14
│   │   ├── JPEGImages
│   │   ├── SegmentationClass
│   │   ├── Sal

Download the pretrained model to initialize the classification network and put it to ./models/.

To train a L2G model on dataset VOC2012, you need to implement the following commands:

cd L2G/
./train_l2g_sal_voc.sh 

For COCO:

cd L2G/
./train_l2g_sal_coco.sh 

We provide the pretrained classification models on PASCAL VOC and MS COCO, respectively.

• Pretrained models for VOC
• Pretrained models for COCO

After the training process, you will need the following command to generate pseudo labels and check their qualities.
For VOC:

./test_l2g_voc.sh

For COCO:

./test_l2g_coco.sh

To train a segmentation model, you need to generate pseudo segmentation labels first by

./gen_gt_voc.sh

This code will generate pseudo segmentation labels in ./data/voc12/pseudo_seg_labels/.
For COCO

./gen_gt_coco.sh

This code will generate pseudo segmentation labels in ./data/coco14/pseudo_seg_labels/.

cd deeplab-pytorch

Download the pretrained models and put them into the pretrained folder.

Train DeepLabv2-resnet101 model by

python main.py train \
      --config-path configs/voc12_resnet_dplv2.yaml

Test the segmentation model by

python main.py test \
    --config-path configs/voc12_resnet_dplv2.yaml \
    --model-path data/models/voc12/voc12_resnet_v2/train_aug/checkpoint_final.pth

Apply the crf post-processing by

python main.py crf \
    --config-path configs/voc12_resnet_dplv2.yaml

If you have any question about L2G, please feel free to contact Me (pt.jiang AT mail DOT nankai.edu.cn).

If you use our codes and models in your research, please cite:

@inproceedings{jiang2022l2g,
  title={L2G: A Simple Local-to-Global Knowledge Transfer Framework for Weakly Supervised Semantic Segmentation},
  author={Jiang, Peng-Tao and Yang, Yuqi and Hou, Qibin and Wei, Yunchao},
  booktitle={Proceedings of the IEEE/CVF conference on computer vision and pattern recognition},
  year={2022}
}

The code is released under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License for NonCommercial use only. Any commercial use should get formal permission first.

Some parts of this code are borrowed from a nice work, EPS.