/111

https://github.com/kakaobrain/autoclint.git

Primary LanguagePythonApache License 2.0Apache-2.0

AutoCLINT

KakaoBrain pytorch tensorflow autocv 1st place HitCount

Automatic Computationally LIght Network Transfer

A specially designed light version of Fast AutoAugment is implemented to adapt to various tasks under limited resources.

This is our solution to NeurIPS 2019 AutoDL Challenges. We rank the AutoCV Challenge 1st place in the final leaderboard.

AutoCV Challenge Introduction

Fully Automated Image Classification without ANY human intervention

Despite recent successes of deep learning and other machine learning techniques, practical experience and expertise is still required to select models and/or choose hyper-parameters when applying techniques to new datasets. This problem is drawing increasing interest, yielding progress towards fully automated solutions. In this challenge your machine learning code is trained and tested on this platform, without human intervention whatsoever, on image classification tasks you have never seen before, with time and memory limitations. All problems are multi-label classification problems, coming from various domains including medical imaging, satellite imaging, object recognition, character recognition, face recognition, etc. They lend themselves to deep learning solutions, but other methods may be used. Raw data is provided, but formatted in a uniform manner, to encourage you to submit generic algorithms.

Methods

We employ a network transfer strategy and implement a light version of Fast AutoAugment for the fast adaptation and the efficient search of data augmentation policies.

Network Transfer

The AutoCV Challenges are given limited memory and computational resources. Thus, we considered a small size of architecture that could use the pre-trained models that were transferred.

We have discovered the optimal hyperparameters and architectures to get the best performance in five minutes from five public data sets (Munster, Chuckey, Pedro, Decal and Hammer). In this process, no data augmentation is used.

Due to the variability in image size (median shape 28x28x1 for munster vs. 576x944x3 for decal) the input tensor size of network must be automatically adapted for each dataset to allow for adequate aggregation of spatial information and to keep the aspect ratio of original image. We automatically adapt these parameters to the median size of each dataset, so that the network effectively trains on entire datasets. Due to time constraints, we do not increase the input tensor volume (without channels) beyond 64^2. If the median shape of the dataset is smaller than 64^2 then we use the median shape as original input.

Munster Chucky Pedro Decal Hammer
original median shape 28x28x1 32x32x1 203x74x3 576x944x3 300x400x3
input tensor shape 28x28x1 32x32x1 128x48x3 48x64x3 48x64x3

Fast AutoAugment

Fast AutoAugment learns augmentation policies using a more efficient search strategy based on density matching. Ideally, Fast AutoAugment should be performed automatically, allowing the training data to adapt to test data.

We modify the search space and implement a light version of Fast AutoAugment algorithm to surmount the restricted computational resources.

As Fast AutoAugment, we search the augmentation policies that match the density of train data with density of augmented valid data. We deviate from the original version in that we replace 5-fold with single-fold search and use random search (within subset of searched policy in original) instead of TPE algorithm.

Results

Public

V1.XLARGE

  • experiment environment: BrainCloud V1.XLARGE Type (V100 1GPU, 14CPU, 122GB)
metrics Munster Chucky Pedro Decal Hammer
ALC 0.9818 0.8633 0.8300 0.8935 0.8764
2*AUC-1 0.9976 0.9292 0.9147 0.9247 0.9106
curves

P1.XLARGE

  • experiment environment: BrainCloud P1.XLARGE Type (P40 1GPU, 6CPU, 61GB)
metrics Munster Chucky Pedro Decal Hammer
ALC 0.9440 0.7835 0.7366 0.8353 0.8286
2*AUC-1 0.9977 0.9353 0.9214 0.9347 0.9142
curves

Private

  • experiment environment: CodaLab (UNKNOWN)
metrics beatriz Caucase Hippoc. Saturn ukulele
ALC 0.6756 0.7359 0.7744 0.8309 0.9075
2*AUC-1 0.8014 0.9411 0.9534 0.9884 0.9985
curves

Environment Setup & Experiments

$ apt update
$ apt install python3-tk
  • clone and init. the repository
$ git clone https://github.com/kakaobrain/autoclint.git && cd autoclint
$ # 3rd parties libarary
$ git submodule init
$ git submodule update
$ # download pretrained models
$ wget https://download.pytorch.org/models/resnet18-5c106cde.pth -O ./models/resnet18-5c106cde.pth
$ # download public datasets
$ cd autodl && python download_public_datasets.py && cd ..
  • run public datasets
$ python autodl/run_local_test.py -time_budget=1200 -code_dir='./' -dataset_dir='autodl/AutoDL_public_data/Munster/'; cp autodl/AutoDL_scoring_output/learning-curve-*.png ./results
$ python autodl/run_local_test.py -time_budget=1200 -code_dir='./' -dataset_dir='autodl/AutoDL_public_data/Chucky/'; cp autodl/AutoDL_scoring_output/learning-curve-*.png ./results
$ python autodl/run_local_test.py -time_budget=1200 -code_dir='./' -dataset_dir='autodl/AutoDL_public_data/Pedro/'; cp autodl/AutoDL_scoring_output/learning-curve-*.png ./results
$ python autodl/run_local_test.py -time_budget=1200 -code_dir='./' -dataset_dir='autodl/AutoDL_public_data/Decal/'; cp autodl/AutoDL_scoring_output/learning-curve-*.png ./results
$ python autodl/run_local_test.py -time_budget=1200 -code_dir='./' -dataset_dir='autodl/AutoDL_public_data/Hammer/'; cp autodl/AutoDL_scoring_output/learning-curve-*.png ./results
  • (optional) display learning curve
$ # item2 utils to visualize learning curve
$ wget https://www.iterm2.com/utilities/imgcat -O bin/imgcat; chmod 0677 bin/imgcat
$ bin/imgcat ./results/learning-curve-*.png

Authors and Licensing

This project is developed by Woonhyuk Baek, Ildoo Kim and Sungbin Lim at Kakao Brain. It is distributed under Apache License 2.0.

Citation

If you apply this library to any project and research, please cite our code:

@misc{autoclint,
  author       = {Kakao Brain},
  title        = {{AutoCLINT}, Automatic Computationally LIght Network Transfer},
  howpublished = {\url{https://github.com/kakaobrain/autoclint}},
  year         = {2019}
}

References & Open sources

  1. Fast AutoAugment
  2. Pretrained models for Pytorch
  3. TorchVision models
  4. TQDM: Progress Bar for Python and CLI
  5. AutoCV/AutoDL startking kit