Skip to content
/ NORM Public

The official project website of "NORM: Knowledge Distillation via N-to-One Representation Matching" (The paper of NORM is published in ICLR 2023).

License

Notifications You must be signed in to change notification settings

OSVAI/NORM

Repository files navigation

Knowledge Distillation via N-to-One Representation Matching

By Xiaolong Liu, Lujun Li, Chao Li and Anbang Yao.

This repository is an official PyTorch implementation of "NORM: Knowledge Distillation via N-to-One Representation Matching" published in ICLR 2023. NORM, the first N-to-one representation matching formulation, which can be readily used to boost the performance of efficient neural networks for different visual recognition tasks.

Installation

This framework is implemented under Pytorch 1.10.1, Python 3.8.5 and CUDA 11.6. It's better to implement an independent virtual environment on machine.

conda create -n pt1101 python=3.8.5
source activate pt1101
pip install torch  # install Pytorch if you do not have it

A Quick Demo

Once the installation is done, you can follow the below steps to run a quick demo.

# assume that you are under the root directory of this project,
# and you have activated your virtual environment if needed.
bash scripts/fetch_pretrained_imagenet_teacher.sh
bash scripts/train_imagenet_resnet50_mobilenet.sh

It will download and save the pretrained models in ./save/models

Training

Here is an example of how to use the code of NORM to train the student model, given a teacher-student network pair.

python train_cifar_student.py --path_t ./save/models/resnet32x4_vanilla/ckpt_epoch_240.pth 
--distill NORM --model_t resnet32x4 --model_s resnet8x4 -r 0.1 -a 0 -b 1.0 -s 8 --trial test

where

  • --path_t: specify the path of the pre-trained teacher model.
  • --distill: specify the method of NORM and its augmented variants. We implemented NORM, NORM+KD and NORM+CRD (NORM_CRD) for teacher-student network pairs on CIFAR100, and NORM on ImageNet.
  • --model_t: name of the pre-trained teacher model. Configurations of all teacher-student network pairs can be found in train_cifar_student.py and train_imagenet_student.py.
  • --model_s: name of the target student model. Configurations of all teacher-student network pairs can be found in train_cifar_student.py and train_imagenet_student.py.
  • -r: the weight of the standard CE loss based on the ground truth labels of training data.
  • -b: the hyper-parameter $\alpha$ in our paper of NORM, weighting the NORM loss.
  • -a: the hyper-parameter $\beta$ in our paper of NORM, weighting the vanilla KD loss defined as the KL divergence between the teacher and student logits.
  • -s: the hyper-parameter $N$ in our paper of NORM, making the student representation have N times feature channels than the teacher representation.
  • --trial: the comments for each teacher-student network pair.
  • other parameters are referred to train_cifar_student.py and train_imagenet_student.py.

Main Results

Table 1: Top-1 mean accuracy (%) comparison on CIFAR-100. The teacher and student have the same type network architectures. The results of the current mainstream KD methods are obtained from the papers of CRD, SemCKD, ReviewKD, SimKD and DistPro. The plain FT and the default FT denote our student feature transform module without and with a linear residual connection, respectively. NORM+KD and NORM+CRD denote combining NORM with the vanilla logits based KD and the contrastive KD, respectively.

Teacher WRN-40-2 WRN-40-2 ResNet56 ResNet110 ResNet110 ResNet32x4 VGG13
Student WRN-16-2 WRN-40-1 ResNet20 ResNet20 ResNet32 ResNet8x4 VGG8
Teacher 75.61 75.61 72.34 74.31 74.31 79.42 74.64
Student(reported in CRD) 73.26 71.98 69.06 69.06 71.14 72.50 70.36
Student(our reproduced) 73.80 71.70 69.53 69.53 71.56 72.87 70.75
Student(w/ 1 plain FT) 72.59 71.14 68.09 68.09 70.17 73.51 70.17
Student(w/ 1 default FT) 73.72 72.09 69.55 69.55 71.64 73.72 70.64
KD 74.92 73.54 70.66 70.67 73.08 73.33 72.98
FitNet 73.58 72.24 69.21 68.99 71.06 73.50 71.02
AT 74.08 72.77 70.55 70.22 72.31 73.44 71.43
SP 73.83 72.43 69.67 70.04 72.69 72.94 72.68
CC 73.56 72.21 69.63 69.48 71.48 72.97 70.71
VID 74.11 73.30 70.38 70.16 72.61 73.09 71.23
RKD 73.35 72.22 69.61 69.25 71.82 71.90 71.48
PKT 74.54 73.45 70.34 70.25 72.61 73.64 72.88
AB 72.50 72.38 69.47 69.53 70.98 73.17 70.94
FT 73.25 71.59 69.84 70.22 72.37 72.86 70.58
FSP 72.91 n/a 69.95 70.11 71.89 72.62 70.23
NST 73.68 72.24 69.60 69.53 71.96 73.30 71.53
CRD 75.48 74.14 71.16 71.46 73.48 75.51 73.94
SRRL n/a 74.64 n/a n/a n/a 75.39 n/a
SemCKD n/a 74.41 n/a n/a n/a 76.23 74.43
ReviewKD 76.12 75.09 71.89 n/a 73.89 75.63 74.84
SimKD n/a 75.56 n/a n/a n/a 78.08 n/a
DistPro 76.36 n/a 72.03 n/a 73.74 n/a n/a
NORM (w/ 1 plain FT) 75.57 74.78 70.70 71.01 73.27 76.76 73.64
NORM 75.65 74.82 71.35 71.55 73.67 76.49 73.95
NORM+KD 76.26 75.42 71.61 72.00 73.95 76.98 74.46
NOMR+CRD 76.02 75.37 71.51 71.90 73.81 76.49 73.58

Table 2: Top-1 mean accuracy (%) comparison on CIFAR-100. The teacher and student have different type network architectures. The results of the current mainstream KD methods are obtained from the papers of CRD, SemCKD, ReviewKD, SimKD and DistPro. The plain FT and the default FT denote our student feature transform module without and with a linear residual connection, respectively. NORM+KD and NORM+CRD denote combining NORM with the vanilla logits based KD and the contrastive KD, respectively.

Teacher VGG13 ResNet50 ResNet50 ResNet32x4 ResNet32x4 WRN-40-2
Student MobileNetV2 MobileNetV2 VGG8 ShuffleNetV1 ShuffleNetV2 ShuffleNetV1
Teacher 74.64 79.34 79.34 79.42 79.42 75.61
Student (reported in CRD) 64.60 64.60 70.36 70.50 71.82 70.50
Student (our reproduced) 64.81 64.81 70.75 71.63 72.96 71.63
Student (w/ 1 plain FT) 63.95 63.95 70.17 71.82 72.55 71.82
Student (w/ 1 residual FT) 64.13 64.13 70.64 71.76 72.71 71.76
KD 67.37 67.35 73.81 74.07 74.45 74.83
FitNet 64.14 63.16 70.69 73.59 73.54 73.73
AT 59.40 58.58 71.84 71.73 72.73 73.32
SP 66.30 68.08 73.34 73.48 74.56 74.52
CC 64.86 65.43 70.25 71.14 71.29 71.38
VID 65.56 67.57 70.30 73.38 73.40 73.61
RKD 64.52 64.43 71.50 72.28 73.21 72.21
PKT 67.13 66.52 73.01 74.10 74.69 73.89
AB 66.06 67.2 70.65 73.55 74.31 73.34
FT 61.78 60.99 70.29 71.75 72.50 72.03
NST 58.16 64.96 71.28 74.12 74.68 74.89
CRD 69.73 69.11 74.30 75.11 75.65 76.05
SRRL n/a n/a n/a 75.18 n/a n/a
SemCKD n/a n/a n/a n/a 77.62 n/a
ReviewKD 70.37 69.89 n/a 77.45 77.78 77.14
SimKD n/a n/a n/a 77.18 n/a n/a
DistPro n/a n/a n/a 77.18 77.54 77.24
NORM (w/ plain FT) 69.37 70.94 74.37 75.93 77.34 76.61
NORM 68.94 70.56 75.17 77.42 78.07 77.06
NORM+KD 69.38 71.17 75.67 77.79 78.32 77.63
NOMR+CRD 69.17 71.08 75.51 77.50 77.96 77.09

Table 3: Top-1 accuracy (%) comparison on ImageNet. The results in the bracket are for our reproduced student baselines, and the results of the current mainstream KD methods are obtained from the papers of CRD, SSKD, SRRL, SemCKD, ReviewKD, SimKD and DistPro.

Teacher Student CC SP ONE SSKD KD AT OFD RKD CRD SRRL SemCKD ReviewKD SimKD DistPro NORM
ResNet34(73.31) ResNet18(70.13) 69.96 70.62 70.55 71.62 70.68 70.59 71.08 71.34 71.17 71.73 70.87 71.61 71.66 71.89 72.14
ResNet50(76.16) MobileNet(69.63) n/a n/a n/a n/a 70.68 70.72 71.25 71.32 71.40 72.49 n/a 72.56 n/a 73.26 74.26

Model Access

Our representative student models trained by NORM can be downloaded from the following links:

Student models trained on CIFAR-100 (see the above Table 1). The teacher and student have the same type network architectures.

Teacher WRN-40-2 WRN-40-2 ResNet56 ResNet110 ResNet110 ResNet32x4 VGG13
Student WRN-16-2 WRN-40-1 ResNet20 ResNet20 ResNet32 ResNet8x4 VGG8
Top-1 accuracy (%) 75.83 75.08 71.45 71.73 73.65 76.74 74.19

Student models trained on CIFAR-100 (see the above Table 2). The teacher and student have the different type network architectures.

Teacher VGG13 ResNet50 ResNet50 ResNet32x4 ResNet32x4 WRN-40-2
Student MobileNetV2 MobileNetV2 VGG8 ShuffleNetV1 ShuffleNetV2 ShuffleNetV1
accuracy 69.11 71.27 75.43 77.19 78.09 77.13

Student models trained on ImageNet (see the above Table 3, and Table 6 of our paper). The teacher and student have the same/different type network architectures.

Teacher ResNet34 ResNet50 ResNet50
Student ResNet18 MobileNet ResNet50-1/4
Top-1 accuracy (%) 72.14 74.26 68.03

Citation

If you find this repository useful to your research, please consider citing:

@inproceedings{liunorm,
  title={NORM: Knowledge Distillation via N-to-One Representation Matching},
  author={Liu, Xiaolong and Li, Lujun and Li, Chao and Yao, Anbang},
  booktitle={The Eleventh International Conference on Learning Representations},
  year={2023},
  url={https://openreview.net/pdf?id=CRNwGauQpb6}
}

Acknowledgement

This repository is built based on RepDistiller. We thank the authors for releasing their amazing codes.

About

The official project website of "NORM: Knowledge Distillation via N-to-One Representation Matching" (The paper of NORM is published in ICLR 2023).

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published