mmaaz60 / EdgeNeXt

[CADL'22, ECCVW] Official repository of paper titled "EdgeNeXt: Efficiently Amalgamated CNN-Transformer Architecture for Mobile Vision Applications".

EdgeNeXt

EdgeNeXt: Efficiently Amalgamated CNN-Transformer Architecture for Mobile Vision Applications [CADL'22, ECCVW]

Muhammad Maaz, Abdelrahman Shaker, Hisham Cholakkal, Salman Khan, Syed Waqas Zamir, Rao Muhammad Anwer and Fahad Shahbaz Khan

🚀 News

• (Jul 26, 2023): SwiftFormer is accepted at ICCV 2023 🔥🔥🔥.

• (Mar 28, 2023): SwiftFormer is released 🔥🔥🔥. Our small variant achieves 78.5% top-1 ImageNet-1K accuracy with only 0.8 ms latency on iPhone 14.

• (Aug 10, 2022): EdgeNeXt-B ImageNet-21K pretrained model is released. It achieves 83.31% top-1 ImageNet-1K accuracy. The weights are available at EdgeNeXt-B-IN21K.

• (Oct 23, 2022): EdgeNeXt is presented at International Workshop on Computational Aspects of Deep Learning at ECCV 2022 in a full length oral presentation.

• (Jul 28, 2022): EdgeNeXt-B model is released. It achieves 82.5% top-1 ImageNet-1K accuracy with 18.51M parameters and 3.84G MAdds. Further, using USI (https://arxiv.org/abs/2204.03475) training recipe, the same model achieves 83.7% accuracy.

• (Jun 28, 2022): EdgeNeXt-S model trained using USI (https://arxiv.org/abs/2204.03475) is released. It achieves 81.1% top-1 ImageNet-1K accuracy with only 5.59M parameters and 1.26G MAdds.

• (Jun 22, 2022): Training and evaluation code along with pre-trained models are released.

---

Abstract: In the pursuit of achieving ever-increasing accuracy, large and complex neural networks are usually developed. Such models demand high computational resources and therefore cannot be deployed on edge devices. It is of great interest to build resource-efficient general purpose networks due to their usefulness in several application areas. In this work, we strive to effectively combine the strengths of both CNN and Transformer models and propose a new efficient hybrid architecture EdgeNeXt. Specifically in EdgeNeXt, we introduce split depth-wise transpose attention (SDTA) encoder that splits input tensors into multiple channel groups and utilizes depth-wise convolution along with self-attention across channel dimensions to implicitly increase the receptive field and encode multi-scale features. Our extensive experiments on classification, detection and segmentation tasks, reveal the merits of the proposed approach, outperforming state-of-the-art methods with comparatively lower compute requirements. Our EdgeNeXt model with 1.3M parameters achieves 71.2% top-1 accuracy on ImageNet-1K, outperforming MobileViT with an absolute gain of 2.2% with 28% reduction in FLOPs. Further, our EdgeNeXt model with 5.6M parameters achieves 79.4% top-1 accuracy on ImageNet-1K.

---

Model Zoo

Name	Acc@1	#Params	MAdds	Model
edgenext_base_usi	83.68	18.51M	3.84G	model
edgenext_base_IN21K	83.31	18.51M	3.84G	model
edgenext_base	82.47	18.51M	3.84G	model
edgenext_small_usi	81.07	5.59M	1.26G	model
edgenext_small	79.41	5.59M	1.26G	model
edgenext_x_small	74.96	2.34M	538M	model
edgenext_xx_small	71.23	1.33M	261M	model
edgenext_small_bn_hs	78.39	5.58M	1.25G	model
edgenext_x_small_bn_hs	74.87	2.34M	536M	model
edgenext_xx_small_bn_hs	70.33	1.33M	260M	model

---

Comparison with SOTA ViTs and Hybrid Architectures

---

Comparison with Previous SOTA MobileViT (ICLR-2022)

---

Qualitative Results (Segmentation)

Installation

1. Create conda environment

conda create --name edgenext python=3.8
conda activate edgenext

2. Install PyTorch and torchvision

pip install torch torchvision --extra-index-url https://download.pytorch.org/whl/cu113

3. Install other dependencies

pip install -r requirements.txt

---

Dataset Preparation

Download the ImageNet-1K classification dataset and structure the data as follows:

/path/to/imagenet-1k/
  train/
    class1/
      img1.jpeg
    class2/
      img2.jpeg
  val/
    class1/
      img3.jpeg
    class2/
      img4.jpeg

---

Evaluation

Download the pretrained weights and run the following command for evaluation on ImageNet-1K dataset.

wget https://github.com/mmaaz60/EdgeNeXt/releases/download/v1.0/edgenext_small.pth
python main.py --model edgenext_small --eval True --batch_size 16 --data_path <path to imagenet> --output_dir <results> --resume edgenext_small.pth

This should give,

Acc@1 79.412 Acc@5 94.512 loss 0.881

Note: For evaluating the USI model, please set usi_eval True.

---

Training

On a single machine with 8 GPUs, run the following command to train EdgeNeXt-S model.

python -m torch.distributed.launch --nproc_per_node=8 main.py \
--model edgenext_small --drop_path 0.1 \
--batch_size 256 --lr 6e-3 --update_freq 2 \
--model_ema true --model_ema_eval true \
--data_path </path/to/imagenet-1k> \
--output_dir </path/to/save_results> \
--use_amp True --multi_scale_sampler

---

Citation

If you use our work, please consider citing:

    @inproceedings{Maaz2022EdgeNeXt,
      title={EdgeNeXt: Efficiently Amalgamated CNN-Transformer Architecture for Mobile Vision Applications},
        author={Muhammad Maaz and Abdelrahman Shaker and Hisham Cholakkal and Salman Khan and Syed Waqas Zamir and Rao Muhammad Anwer and Fahad Shahbaz Khan},
      booktitle={International Workshop on Computational Aspects of Deep Learning at 17th European Conference on Computer Vision (CADL2022)},
      year={2022},
      organization={Springer}
}

---

Contact

Should you have any question, please create an issue on this repository or contact at [e-mail] & [e-mail]

---

References

Our code is based on ConvNeXt repository. We thank them for releasing their code.

Our Related Works

• SwiftFormer: Efficient Additive Attention for Transformer-based Real-time Mobile Vision Applications. Paper | Code.