Awesome
RainNet — Official Pytorch Implementation
Region-aware Adaptive Instance Normalization for Image Harmonization<br> Jun Ling, Han Xue, Li Song*, Rong Xie, Xiao Gu
Update
- 2021.07. We trained a 512x512 resolution model with several data augmentation methods, including random flip(horizontal, vertical), and random crop. The PSNR score is 38.14 now. Download the model via Google Drive, Baidu Drive (code: n1fl )
Table of Contents
Introduction
This work treats image harmonization as a style transfer problem. In particular, we propose a simple yet effective Region-aware Adaptive Instance Normalization (RAIN) module, which explicitly formulates the visual style from the background and adaptively applies them to the foreground. With our settings, our RAIN module can be used as a drop-in module for existing image harmonization networks and is able to bring significant improvements. Extensive experiments on the existing image harmonization benchmark datasets shows the superior capability of the proposed method.
Preparation
1. Clone this repo:
git clone https://github.com/junleen/RainNet
cd RainNet
2. Requirements
- Both Linux and Windows are supported, but Linux is recommended for compatibility reasons.
- We have tested on Python 3.6 with PyTorch 1.4.0 and PyTorch 1.8.1+cu11.
install the required packages using pip:
pip3 install -r requirements.txt
or conda:
conda create -n rainnet python=3.6
conda activate rainnet
pip install -r requirements.txt
3. Prepare the data
- Download iHarmony4 dataset and extract the images. Because the images are too big in the origianl dataset, we suggest you to resize the images (eg, 512x512, or 256x256) and save the resized images in your local device.
- We provide the code in
data/preprocess_iharmony4.py
. For example, you can run:
This will help you to resize the images to a fixed size, eg,python data/preprocess_iharmony4.py --dir_iharmony4 <DIR_of_iHarmony4> --save_dir <SAVE_DIR> --image_size <IMAGE_SIZE>
<image_size, image_size>
. If you want to keep the aspect ratio of the original images, please run:python data/preprocess_iharmony4.py --dir_iharmony4 <DIR_of_iHarmony4> --save_dir <SAVE_DIR> --image_size <IMAGE_SIZE> --keep_aspect_ratio
4. Download our pre-trained model
- Download the pretrained model from Google Drive or Baidu Drive (code: 3qjk ), and put
net_G_last.pth
(notnet_G.pth
) in the directorycheckpoints/experiment_train
. You can also save the checkpoint in other directories and change thecheckpoints_dir
andname
in/util/config.py
accordingly.
Usage
1. Evaluation
We provide the code in evaluate.py
, which supports the model evaluation in iHarmony4 dataset.
Run:
python evaluate.py --dataset_root <DATA_DIR> --save_dir evaluated --batch_size 16 --device cuda
If you want to save the harmonized images, you can add --store_image
at the end of the command. The evaluating results will be saved in the evaluated
directory.
2. Testing with your own examples
In this project, we also provide the easy testing code in test.py
to help you test on other cases. However, you are required to assign image paths in the file for each trial. For example, you can follow:
comp_path = 'examples/1.png' or ['examples/1.png', 'examples/2.png']
mask_path = 'examples/1-mask.png' or ['examples/1-mask.png', 'examples/2-mask.png']
real_path = 'examples/1-gt.png' or ['examples/1-gt.png', 'examples/2-gt.png']
If there is no groundtruth image, you can set real_path
to None
3. Training your own model
Please update the command arguments in scripts/train.sh
and run:
bash scripts/train.sh
Results
Citation
If you use our code or find this work useful for your future research, please kindly cite our paper:
@inproceedings{ling2021region,
title={Region-aware Adaptive Instance Normalization for Image Harmonization},
author={Ling, Jun and Xue, Han and Song, Li and Xie, Rong and Gu, Xiao},
booktitle={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition},
pages={9361--9370},
year={2021}
}
Acknowledgement
For some of the data modules and model functions used in this source code, we need to acknowledge the repo of DoveNet and pix2pix.