supmae: A Jupyter Notebook repository from EnyAC

SupMAE: Supervised Masked Autoencoders Are Efficient Vision Learners

This is a offical PyTorch/GPU implementation of the paper SupMAE: Supervised Masked Autoencoders Are Efficient Vision Learners.

This repo is a modification on the MAE repo. Installation and preparation follow that repo.
This repo is based on timm==0.3.2, for which a fix is needed to work with PyTorch 1.8.1+.

TL;DR

Supervised MAE (SupMAE) is an extension of MAE by adding a supervised classification branch. SupMAE is efficient and can achieve comparable performance with MAE using only 30% compute. SupMAE’s robustness on ImageNet variants and transfer learning performance outperforms MAE and standard supervised pre-training counterparts.

1️⃣ SupMAE is more training efficient

2️⃣ SupMAE model is more robust

dataset	MAE	DeiT	SupMAE(Ours)
IN-Corruption ↓	51.7	47.4	48.1
IN-Adversarial	35.9	27.9	35.5
IN-Rendition	48.3	45.3	51.0
IN-Sketch	34.5	32.0	36.0
Score	41.8	39.5	43.6

Note: The score is measured by the averaging metric across four variants (we use ’100 - error’ for the IN-Corruption performance metric).

3️⃣ SupMAE learns more transferable features

Few-shot learning on 20 classification datasets

	Checkpoint	Method	5-shot	20-shot	50-shot
Linear Probe	MAE	Self-Sup.	33.37 ± 1.98	48.03 ± 2.70	58.26 ± 0.84
Linear Probe	MoCo-v3	Self-Sup.	50.17 ± 3.43	61.99 ± 2.51	69.71 ± 1.03
Linear Probe	SupMAE(Ours)	Sup.	47.97 ± 0.44	60.86 ± 0.31	66.68 ± 0.47
Fine-tune	MAE	Self-Sup.	36.10 ± 3.25	54.13 ± 3.86	65.86 ± 2.42
Fine-tune	MoCo-v3	Self-Sup.	39.30 ± 3.84	58.75 ± 5.55	70.33 ± 1.64
Fine-tune	SupMAE(Ours)	Sup.	46.76 ± 0.12	64.61 ± 0.82	71.71 ± 0.66

Note: We are using the Elevater_Toolkit_IC (HIGHLY recommendation)!

Semantic segmentation with ADE-20k

method	mIoU	aAcc	mAcc
Naive supervised	47.4	-	-
MAE	48.6	82.8	59.4
SupMAE (ours)	49.0	82.7	60.2

Note: We are using mmsegmentaion

Abstract

Recently, self-supervised Masked Autoencoders (MAE) have attracted unprecedented attention for their impressive representation learning ability. However, the pretext task, Masked Image Modeling (MIM), reconstructs the missing local patches, lacking the global understanding of the image. This paper extends MAE to a fully-supervised setting by adding a supervised classification branch, thereby enabling MAE to effectively learn global features from golden labels. The proposed Supervised MAE (SupMAE) only exploits a visible subset of image patches for classification, unlike the standard supervised pre-training where all image patches are used. Through experiments, we demonstrate that not only is SupMAE more training efficient but also it learns more robust and transferable features.

Catalog

Pre-training code
Fine-tuning code
Pre-trained checkpoints & logs

Pre-trained checkpoints & logs

Due to computation constraint, we ONLY test the ViT-B/16 model.

	Pre-training	Fine-tuning
checkpoint	ckpt md5: `d83c8a`	ckpt md5: `1fb748`
logs	log	log

Pre-training

The pre-training instruction is in PRETRAIN.md.

Fine-tuning

The fine-tuning instruction is in FINETUNE.md.

Citation

If you find this repository helpful, please consider citing our work

@article{liang2022supmae,
  title={SupMAE: Supervised Masked Autoencoders Are Efficient Vision Learners},
  author={Liang, Feng and Li, Yangguang and Marculescu, Diana},
  journal={arXiv preprint arXiv:2205.14540},
  year={2022}
}

License

This project is under the CC-BY-NC 4.0 license. See LICENSE for details.

enyac-group/supmae