Mixup for Supervision, Semi- and Self-Supervision Learning Toolbox and Benchmark
Project description
OpenMixup
📘Documentation | 🛠️Installation | 🚀Model Zoo | 👀Awesome Mixup | 🔍Awesome MIM | 🆕News
Introduction
The main branch works with PyTorch 1.8 (required by some self-supervised methods) or higher (we recommend PyTorch 1.12). You can still use PyTorch 1.6 for supervised classification methods.
OpenMixup
is an open-source toolbox for supervised, self-, and semi-supervised visual representation learning with mixup based on PyTorch, especially for mixup-related methods. Recently, OpenMixup
is on updating to adopt new features and code structures of OpenMMLab 2.0 (#42).
Major Features
-
Modular Design. OpenMixup follows a similar code architecture of OpenMMLab projects, which decompose the framework into various components, and users can easily build a customized model by combining different modules. OpenMixup is also transplantable to OpenMMLab projects (e.g., MMPreTrain).
-
All in One. OpenMixup provides popular backbones, mixup methods, semi-supervised, and self-supervised algorithms. Users can perform image classification (CNN & Transformer) and self-supervised pre-training (contrastive and autoregressive) under the same framework.
-
Standard Benchmarks. OpenMixup supports standard benchmarks of image classification, mixup classification, self-supervised evaluation, and provides smooth evaluation on downstream tasks with open-source projects (e.g., object detection and segmentation on Detectron2 and MMSegmentation).
-
State-of-the-art Methods. Openmixup provides awesome lists of popular mixup and self-supervised methods. OpenMixup is updating to support more state-of-the-art image classification and self-supervised methods.
Table of Contents
News and Updates
[2023-12-23] OpenMixup
v0.2.9 is released, updating more features in mixup augmentations, self-supervised learning, and optimizers.
Installation
OpenMixup is compatible with Python 3.6/3.7/3.8/3.9 and PyTorch >= 1.6. Here are quick installation steps for development:
conda create -n openmixup python=3.8 pytorch=1.12 cudatoolkit=11.3 torchvision -c pytorch -y
conda activate openmixup
pip install openmim
mim install mmcv-full
git clone https://github.com/Westlake-AI/openmixup.git
cd openmixup
python setup.py develop
Please refer to install.md for more detailed installation and dataset preparation.
Getting Started
OpenMixup supports Linux and macOS. It enables easy implementation and extensions of mixup data augmentation methods in existing supervised, self-, and semi-supervised visual recognition models. Please see get_started.md for the basic usage of OpenMixup.
Training and Evaluation Scripts
Here, we provide scripts for starting a quick end-to-end training with multiple GPUs
and the specified CONFIG_FILE
.
bash tools/dist_train.sh ${CONFIG_FILE} ${GPUS} [optional arguments]
For example, you can run the script below to train a ResNet-50 classifier on ImageNet with 4 GPUs:
CUDA_VISIBLE_DEVICES=0,1,2,3 PORT=29500 bash tools/dist_train.sh configs/classification/imagenet/resnet/resnet50_4xb64_cos_ep100.py 4
After training, you can test the trained models with the corresponding evaluation script:
bash tools/dist_test.sh ${CONFIG_FILE} ${GPUS} ${PATH_TO_MODEL} [optional arguments]
Development
Please see Tutorials for more developing examples and tech details:
Downetream Tasks for Self-supervised Learning
Useful Tools
Overview of Model Zoo
Please run experiments or find results on each config page. Refer to Mixup Benchmarks for benchmarking results of mixup methods. View Model Zoos Sup and Model Zoos SSL for a comprehensive collection of mainstream backbones and self-supervised algorithms. We also provide the paper lists of Awesome Mixups and Awesome MIM for your reference. Please view config files and links to models at the following config pages. Checkpoints and training logs are on updating!
-
Backbone architectures for supervised image classification on ImageNet.
Currently supported backbones
- AlexNet (NIPS'2012) [config]
- VGG (ICLR'2015) [config]
- InceptionV3 (CVPR'2016) [config]
- ResNet (CVPR'2016) [config]
- ResNeXt (CVPR'2017) [config]
- SE-ResNet (CVPR'2018) [config]
- SE-ResNeXt (CVPR'2018) [config]
- ShuffleNetV1 (CVPR'2018) [config]
- ShuffleNetV2 (ECCV'2018) [config]
- MobileNetV2 (CVPR'2018) [config]
- MobileNetV3 (ICCV'2019) [config]
- EfficientNet (ICML'2019) [config]
- EfficientNetV2 (ICML'2021) [config]
- HRNet (TPAMI'2019) [config]
- Res2Net (ArXiv'2019) [config]
- CSPNet (CVPRW'2020) [config]
- RegNet (CVPR'2020) [config]
- Vision-Transformer (ICLR'2021) [config]
- Swin-Transformer (ICCV'2021) [config]
- PVT (ICCV'2021) [config]
- T2T-ViT (ICCV'2021) [config]
- LeViT (ICCV'2021) [config]
- RepVGG (CVPR'2021) [config]
- DeiT (ICML'2021) [config]
- MLP-Mixer (NIPS'2021) [config]
- Twins (NIPS'2021) [config]
- ConvMixer (Openreview'2021) [config]
- BEiT (ICLR'2022) [config]
- UniFormer (ICLR'2022) [config]
- MobileViT (ICLR'2022) [config]
- PoolFormer (CVPR'2022) [config]
- ConvNeXt (CVPR'2022) [config]
- MViTV2 (CVPR'2022) [config]
- RepMLP (CVPR'2022) [config]
- VAN (CVMJ'2023) [config]
- DeiT-3 (ECCV'2022) [config]
- LITv2 (NIPS'2022) [config]
- HorNet (NIPS'2022) [config]
- DaViT (ECCV'2022) [config]
- EdgeNeXt (ECCVW'2022) [config]
- EfficientFormer (ArXiv'2022) [config]
- MogaNet (ICLR'2024) [config]
- MetaFormer (ArXiv'2022) [config]
- ConvNeXtV2 (ArXiv'2023) [config]
- CoC (ICLR'2023) [config]
- MobileOne (CVPR'2023) [config]
- VanillaNet (ArXiv'2023) [config]
- RWKV (ArXiv'2023) [config]
-
Mixup methods for supervised image classification.
Currently supported mixup methods
- Mixup (ICLR'2018) [config]
- CutMix (ICCV'2019) [config]
- ManifoldMix (ICML'2019) [config]
- FMix (ArXiv'2020) [config]
- AttentiveMix (ICASSP'2020) [config]
- SmoothMix (CVPRW'2020) [config]
- SaliencyMix (ICLR'2021) [config]
- PuzzleMix (ICML'2020) [config]
- SnapMix (AAAI'2021) [config]
- GridMix (Pattern Recognition'2021) [config]
- ResizeMix (CVMJ'2023) [config]
- AlignMix (CVPR'2022) [config]
- TransMix (CVPR'2022) [config]
- AutoMix (ECCV'2022) [config]
- SAMix (ArXiv'2021) [config]
- DecoupleMix (NeurIPS'2023) [config]
- SMMix (ICCV'2023) [config]
- AdAutoMix (ICLR'2024) [config]
Currently supported datasets for mixups
- ImageNet [download (1K)] [download (21K)] [config]
- CIFAR-10 [download] [config]
- CIFAR-100 [download] [config]
- Tiny-ImageNet [download] [config]
- FashionMNIST [download]
- STL-10 [download]
- CUB-200-2011 [download] [config]
- FGVC-Aircraft [download] [config]
- Stanford-Cars [download]
- Places205 [download] [config]
- iNaturalist-2017 [download] [config]
- iNaturalist-2018 [download] [config]
- AgeDB [download] [download (baidu)] [config]
- IMDB-WIKI [download (imdb)] [download (wiki)] [config]
- RCFMNIST [download] [config]
-
Self-supervised algorithms for visual representation learning.
Currently supported self-supervised algorithms
- Relative Location (ICCV'2015) [config]
- Rotation Prediction (ICLR'2018) [config]
- DeepCluster (ECCV'2018) [config]
- NPID (CVPR'2018) [config]
- ODC (CVPR'2020) [config]
- MoCov1 (CVPR'2020) [config]
- SimCLR (ICML'2020) [config]
- MoCoV2 (ArXiv'2020) [config]
- BYOL (NIPS'2020) [config]
- SwAV (NIPS'2020) [config]
- DenseCL (CVPR'2021) [config]
- SimSiam (CVPR'2021) [config]
- Barlow Twins (ICML'2021) [config]
- MoCoV3 (ICCV'2021) [config]
- BEiT (ICLR'2022) [config
- MAE (CVPR'2022) [config]
- SimMIM (CVPR'2022) [config]
- MaskFeat (CVPR'2022) [config]
- CAE (ArXiv'2022) [config]
- A2MIM (ICML'2023) [config]
Change Log
Please refer to changelog.md for more details and release history.
License
This project is released under the Apache 2.0 license. See LICENSE
for more information.
Acknowledgement
- OpenMixup is an open-source project for mixup methods and visual representation learning created by researchers in CAIRI AI Lab. We encourage researchers interested in backbone architectures, mixup augmentations, and self-supervised learning methods to contribute to OpenMixup!
- This project borrows the architecture design and part of the code from MMPreTrain and the official implementations of supported algorisms.
Citation
If you find this project useful in your research, please consider star OpenMixup
or cite our tech report:
@article{li2022openmixup,
title = {OpenMixup: A Comprehensive Mixup Benchmark for Visual Classification},
author = {Siyuan Li and Zedong Wang and Zicheng Liu and Di Wu and Cheng Tan and Stan Z. Li},
journal = {ArXiv},
year = {2022},
volume = {abs/2209.04851}
}
Contributors and Contact
For help, new features, or reporting bugs associated with OpenMixup, please open a GitHub issue and pull request with the tag "help wanted" or "enhancement". For now, the direct contributors include: Siyuan Li (@Lupin1998), Zedong Wang (@Jacky1128), and Zicheng Liu (@pone7). We thank all public contributors and contributors from MMPreTrain (MMSelfSup and MMClassification)!
This repo is currently maintained by:
- Siyuan Li (lisiyuan@westlake.edu.cn), Westlake University
- Zedong Wang (wangzedong@westlake.edu.cn), Westlake University
- Zicheng Liu (liuzicheng@westlake.edu.cn), Westlake University
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for openmixup-0.2.9-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a6eee661e76daffff65cdd475ad77c36233d892f53f07f50ab40681a686463e5 |
|
MD5 | 3219fac9b3010d6b506956c9b9855851 |
|
BLAKE2b-256 | 6c9e4854611bfdc715acee6f68d65087593da5c808557073f69a1805590ddbcb |