All Projects → clovaai → Cutblur

clovaai / Cutblur

Licence: mit
Rethinking Data Augmentation for Image Super-resolution (CVPR 2020)

Projects that are alternatives of or similar to Cutblur

Nlpython
This repository contains the code related to Natural Language Processing using python scripting language. All the codes are related to my book entitled "Python Natural Language Processing"
Stars: ✭ 265 (-1.49%)
Mutual labels:  jupyter-notebook
Tutorial
A tutorial for widgets
Stars: ✭ 267 (-0.74%)
Mutual labels:  jupyter-notebook
Noah Research
Noah Research
Stars: ✭ 265 (-1.49%)
Mutual labels:  jupyter-notebook
Advhat
AdvHat: Real-world adversarial attack on ArcFace Face ID system
Stars: ✭ 268 (-0.37%)
Mutual labels:  jupyter-notebook
Cookiecutter Docker Science
Cookiecutter template for data scientists working with Docker containers
Stars: ✭ 267 (-0.74%)
Mutual labels:  jupyter-notebook
Parallel Tutorial
Parallel computing in Python tutorial materials
Stars: ✭ 268 (-0.37%)
Mutual labels:  jupyter-notebook
Embeddedsystem
📚 嵌入式系统基础知识与主流编程语言相关内容总结
Stars: ✭ 266 (-1.12%)
Mutual labels:  jupyter-notebook
Deep Learning
No description, website, or topics provided.
Stars: ✭ 3,058 (+1036.8%)
Mutual labels:  jupyter-notebook
Deeplearning.ai Assignments
Stars: ✭ 268 (-0.37%)
Mutual labels:  jupyter-notebook
Facet
Human-explainable AI.
Stars: ✭ 269 (+0%)
Mutual labels:  jupyter-notebook
Introduction To Machine Learning
This repo will house all our course material and code snippets from the Introduction to Machine Learning Class
Stars: ✭ 267 (-0.74%)
Mutual labels:  jupyter-notebook
Lstm pose machines
Code repo for "LSTM Pose Machines" (CVPR'18)
Stars: ✭ 268 (-0.37%)
Mutual labels:  jupyter-notebook
Pgmpy notebook
Short Tutorial to Probabilistic Graphical Models(PGM) and pgmpy
Stars: ✭ 268 (-0.37%)
Mutual labels:  jupyter-notebook
Quantum
Stars: ✭ 268 (-0.37%)
Mutual labels:  jupyter-notebook
Graph nn
Graph Classification with Graph Convolutional Networks in PyTorch (NeurIPS 2018 Workshop)
Stars: ✭ 268 (-0.37%)
Mutual labels:  jupyter-notebook
Movielens
4 different recommendation engines for the MovieLens dataset.
Stars: ✭ 265 (-1.49%)
Mutual labels:  jupyter-notebook
Pytorch tiramisu
FC-DenseNet in PyTorch for Semantic Segmentation
Stars: ✭ 267 (-0.74%)
Mutual labels:  jupyter-notebook
Gophernotes
The Go kernel for Jupyter notebooks and nteract.
Stars: ✭ 3,100 (+1052.42%)
Mutual labels:  jupyter-notebook
Pytorch Kaggle Starter
Pytorch starter kit for Kaggle competitions
Stars: ✭ 268 (-0.37%)
Mutual labels:  jupyter-notebook
Geopython
Notebooks and libraries for spatial/geo Python explorations
Stars: ✭ 268 (-0.37%)
Mutual labels:  jupyter-notebook

Rethinking Data Augmentation for Image Super-resolution (CVPR 2020)

This repository provides the official PyTorch implementation of the following paper:

Rethinking Data Augmentation for Image Super-resolution: A Comprehensive Analysis and a New Strategy
Jaejun Yoo*1, Namhyuk Ahn*2, Kyung-Ah Sohn2
* indicates equal contribution. Most work was done in NAVER Corp.
1 EPFL
2 Ajou University
https://arxiv.org/abs/2004.00448

Abstract: Data augmentation is an effective way to improve the performance of deep networks. Unfortunately, current methods are mostly developed for high-level vision tasks (e.g., classification) and few are studied for low-level vision tasks (e.g., image restoration). In this paper, we provide a comprehensive analysis of the existing augmentation methods applied to the super-resolution task. We find that the methods discarding or manipulating the pixels or features too much hamper the image restoration, where the spatial relationship is very important. Based on our analyses, we propose CutBlur that cuts a low-resolution patch and pastes it to the corresponding high-resolution image region and vice versa. The key intuition of CutBlur is to enable a model to learn not only "how" but also "where" to super-resolve an image. By doing so, the model can understand "how much", instead of blindly learning to apply super-resolution to every given pixel. Our method consistently and significantly improves the performance across various scenarios, especially when the model size is big and the data is collected under real-world environments. We also show that our method improves other low-level vision tasks, such as denoising and compression artifact removal.

0. Requirement

Simpy run:

pip3 install -r requirements.txt

1. Quick Start (Demo)

You can test our models with any images. Place images in ./input directory and run the below script.
Before executing the script, please download the pretrained model on CutBlur_model and change the --model and --pretrain arguments appropriately.

python inference.py \
    --model [EDSR|RCAN|CARN] \
    --pretrain <path_of_pretrained_model> \
    --dataset_root ./input \
    --save_root ./output

We also provide a demo to visualize how the mixture of augmentation (MoA) prevent the SR model from over-sharpening.

2. Dataset

DIV2K

We use the DIV2K dataset to train the model. Download and unpack the tar file any directory you want.
Important: For the DIV2K dataset only, all the train and valid images should be placed in the DIV2K_train_HR and DIV2K_train_LR_bicubic directories (We parse train and valid images using --div2k_range argument).

SR Benchmark

For the benchmark dataset used in the paper (Set14, Urban100, and manga109), we provide original images on here.

RealSR

We use the RealSR dataset (version 1). In the paper, we utilized both Canon and Nikon images for train and test.

3. Evaluate Pre-trained Models

For the folks who want to compare our result, we provide our result generated on the RealSR and SR benchmark dataset.

We present an example script to evaluate the pretrained model below:

python main.py \
    --dataset [DIV2K_SR|RealSR|Set14_SR|Urban100_SR|manga109_SR] \
    --model [EDSR|RCAN|CARN] \
    --pretrain <path_of_pretrained_model> \
    --dataset_root <directory_of_dataset> \
    --save_root ./output
    --test_only

For --dataset argument, _SR postfix is required to identify the task among SR, DN and JPEG restoration.
And if you evaluate on the DIV2K_SR, please add --div2k_range 1-800/801-900 argument to specify the range of the images you use.

Note that, [DIV2K, Set14_SR, Urban100_SR, manga109_SR] have to be evaluate using the model trained on the DIV2K dataset (e.g. DIV2K_EDSR_moa.pt) while [RealSR] via the model with RealSR dataset (e.g. RealSR_EDSR_moa.pt).

4. Train Models

DIV2K (bicubic)

To achieve the result in the paper, X2 scale pretraining is necessary. First, train the model on the X2 scale as below:

python main.py \
    --use_moa \
    --model [EDSR|RCAN|CARN] \
    --dataset DIV2K_SR \
    --div2k_range 1-800/801-810 \
    --scale 2 \
    --dataset_root <directory_of_dataset>

If you want to train the baseline model, discard --use_moa option.

By default, the trained model will be saved in ./pt directory. And since evaluating the whole valid images takes a lot of time, we just validated the model on the first ten images during training.

Then, fine-tune the trained model on the X4 scale:

python main.py \
    --use_moa \
    --model [EDSR|RCAN|CARN] \
    --dataset DIV2K_SR \
    --div2k_range 1-800/801-810 \
    --scale 4 \
    --pretrain <path_of_pretrained_model> \
    --dataset_root <directory_of_dataset>

Please see the option.py for more detailed options.

RealSR

Simply run this code:

python main.py \
    --use_moa \
    --model [EDSR|RCAN|CARN] \
    --dataset RealSR \
    --scale 4 --camera all \
    --dataset_root <directory_of_dataset>

Updates

  • 02 Apr, 2020: Initial upload.

License

Copyright (c) 2020-present NAVER Corp.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

Citation

@article{yoo2020rethinking,
  title={Rethinking Data Augmentation for Image Super-resolution: A Comprehensive Analysis and a New Strategy},
  author={Yoo, Jaejun and Ahn, Namhyuk and Sohn, Kyung-Ah},
  journal={arXiv preprint arXiv:2004.00448},
  year={2020}
}
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].