close
The Wayback Machine - https://web.archive.org/web/20200614122040/https://github.com/ericsujw/InstColorization
Skip to content
No description or website provided.
Jupyter Notebook Python
Branch: master
Clone or download

Latest commit

Image Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Image checkpoints Update README.md May 21, 2020
Image data runnable fusion model May 9, 2020
Image example Update README.md May 20, 2020
Image imgs Update teaser May 21, 2020
Image models upload weight path May 10, 2020
Image options Fix some default settings May 10, 2020
Image scripts Update install process May 28, 2020
Image util runnable fusion model May 9, 2020
Image InstColorization.ipynb Add colab May 20, 2020
Image LICENSE Fix some default settings May 10, 2020
Image README.md Update install process May 28, 2020
Image download.py Update checkpoints May 19, 2020
Image env.yml Update install process May 28, 2020
Image fusion_dataset.py update instances number May 19, 2020
Image image_util.py update instances number May 19, 2020
Image inference_bbox.py
Image test_fusion.py add detectron 2 May 9, 2020

README.md

[CVPR 2020] Instance-aware Image Colorization

Open In Colab

[Paper] [Project Website] [Google Colab]

Image

Image colorization is inherently an ill-posed problem with multi-modal uncertainty. Previous methods leverage the deep neural network to map input grayscale images to plausible color outputs directly. Although these learning-based methods have shown impressive performance, they usually fail on the input images that contain multiple objects. The leading cause is that existing models perform learning and colorization on the entire image. In the absence of a clear figure-ground separation, these models cannot effectively locate and learn meaningful object-level semantics. In this paper, we propose a method for achieving instance-aware colorization. Our network architecture leverages an off-the-shelf object detector to obtain cropped object images and uses an instance colorization network to extract object-level features. We use a similar network to extract the full-image features and apply a fusion module to full object-level and image-level features to predict the final colors. Both colorization networks and fusion modules are learned from a large-scale dataset. Experimental results show that our work outperforms existing methods on different quality metrics and achieves state-of-the-art performance on image colorization.

Instance-aware Image Colorization
Jheng-Wei Su, Hung-Kuo Chu, and Jia-Bin Huang
In IEEE Conference on Computer Vision and Pattern Recognition (CVPR), 2020.

Prerequisites

  • CUDA 10.1
  • Python3
  • Pytorch >= 1.5
  • Detectron2
  • OpenCV-Python
  • Pillow/scikit-image
  • Please refer to the env.yml for detail dependencies.

Getting Started

  1. Clone this repo:
git clone https://github.com/ericsujw/InstColorization
cd InstColorization
  1. Install conda.
  2. Install all the dependencies
conda env create --file env.yml
  1. Switch to the conda environment
conda activate instacolorization
  1. Install other dependencies
sh scripts/install.sh

Pretrained Model

  1. Download it from google drive.
sh scripts/download_model.sh
  1. Now the pretrained models would place in checkpoints.

Instance Prediction

Please follow the command below to predict all the bounding boxes fo the images in example folder.

python inference_bbox.py --test_img_dir example

All the prediction results would save in example_bbox folder.

Colorize Images

Please follow the command below to colorize all the images in example foler.

python test_fusion.py --name test_fusion --sample_p 1.0 --model fusion --fineSize 256 --test_img_dir example --results_img_dir results

All the colorized results would save in results folder.

License

This work is licensed under MIT License. See LICENSE for details.

Citation

If you find our code/models useful, please consider citing our paper:

@inproceedings{Su-CVPR-2020,
  author = {Su, Jheng-Wei and Chu, Hung-Kuo and Huang, Jia-Bin},
  title = {Instance-aware Image Colorization},
  booktitle = {IEEE Conference on Computer Vision and Pattern Recognition (CVPR)},
  year = {2020}
}

Acknowledgments

Our code borrows heavily from the amazing colorization-pytorch repository.

You can’t perform that action at this time.