This repository is an official PyTorch implementation of the ICML paper:

Deep Isometric Learning for Visual Recognition
Haozhi Qi, Chong You, Xiaolong Wang, Yi Ma, Jitendra Malik
International Conference on Machine Learning (ICML), 2020
[Project Webpage], [arXiv]

In this project, we argue the notion of isometry is a central guiding principle for training deep ConvNet. In particular, we take a minimalist approach and show that a vanilla deep Isometric Network (ISONet) (i.e., without BN and shortcut) can be trained and achieve suprisingly good accuracy. We also show that if combined with skip connections, such near isometric networks (i.e. R-ISONet) can achieve performances on par with the standard ResNet, even without normalization at all.

Here we show the Top-1 Classification Accuracy on ImageNet Validation dataset:

For more results and pretrained models, see Model Zoo.

The ImageNet folder train/val folder should locate at data/ILSVRC2012/train and data/ILSVRC2012/val, respectively.

This codebase is developed and tested with python 3.6, PyTorch 1.4, and cuda 10.1. But any version newer than that should work.

Here we gave an example of installing ISONet using conda virtual environment:

git clone https://github.com/HaozhiQi/ISONet
cd ISONet
conda create -y -n isonet
conda activate isonet
# install pytorch according to https://pytorch.org/
conda install -y pytorch==1.4 torchvision cudatoolkit=10.1 -c pytorch
pip install yacs

You can download the pre-trained models from the links in Model Zoo.

For example, if we want to test the performance of R-ISONet 18, download it from model zoo, and use the following command:

# change config files if you are going to test other pre-trained models
python test.py --cfg configs/IN1k-RISO18.yaml --gpus {GPU_ID} --ckpt RISO18.pt

To train our model from scratch, use the following command:

python train.py --cfg {CONFIG_FILE} --gpus {GPU_ID} --output {OUTPUT_NAME}

If you find ISONet or this codebase helpful in your research, please consider citing:

@InProceedings{qi2020deep,
  author={Qi, Haozhi and You, Chong and Wang, Xiaolong and Ma, Yi and Malik, Jitendra},
  title={Deep Isometric Learning for Visual Recognition},
  booktitle={ICML},
  year={2020}
}