• Stars
    star
    342
  • Rank 123,697 (Top 3 %)
  • Language
    Python
  • License
    MIT License
  • Created over 2 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

[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

Website paper video slides

๐Ÿš€ News

  • (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.


main figure

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

results


Comparison with Previous SOTA MobileViT (ICLR-2022)

results


Qualitative Results (Segmentation)

results

Installation

  1. Create conda environment
conda create --name edgenext python=3.8
conda activate edgenext
  1. Install PyTorch and torchvision
pip install torch torchvision --extra-index-url https://download.pytorch.org/whl/cu113
  1. 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 [email protected] & [email protected]


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.