Giter VIP home page Giter VIP logo

starenhancer's Introduction

StarEnhancer: Learning Real-Time and Style-Aware Image Enhancement

paper paper GoogleDrive BaiduPan Basic Enhancer

Abstract: Image enhancement is a subjective process whose targets vary with user preferences. In this paper, we propose a deep learning-based image enhancement method covering multiple tonal styles using only a single model dubbed StarEnhancer. It can transform an image from one tonal style to another, even if that style is unseen. With a simple one-time setting, users can customize the model to make the enhanced images more in line with their aesthetics. To make the method more practical, we propose a well-designed enhancer that can process a 4K-resolution image over 200 FPS but surpasses the contemporaneous single style image enhancement methods in terms of PSNR, SSIM, and LPIPS. Finally, our proposed enhancement method has good interactability, which allows the user to fine-tune the enhanced image using intuitive options.

StarEnhancer

Getting started

Install

We test the code on PyTorch 1.8.1 + CUDA 11.1 + cuDNN 8.0.5, and close versions also work fine.

pip install -r requirements.txt

We mainly train the model on RTX 2080Ti * 4, but a smaller mini batch size can also work.

Prepare

You can generate your own dataset, or download the one we generate.

The final file path should be the same as the following:

┬─ save_model
│   ├─ stylish.pth.tar
│   └─ ... (model & embedding)
└─ data
    ├─ train
    │   ├─ 01-Experts-A
    │   │   ├─ a0001.jpg
    │   │   └─ ... (id.jpg)
    │   └─ ... (style folder)
    ├─ valid
    │   └─ ... (style folder)
    └─ test
        └─ ... (style folder)

Download

Data and pretrained models are available on GoogleDrive or BaiduPan (jvyf).

Generate

  1. Download raw data from MIT-Adobe FiveK Dataset.
  2. Download the modified Lightroom database fivek.lrcat, and replace the original database with it.
  3. Generate dataset in JPEG format with quality 100, which can refer to this issue.
  4. Run generate_dataset.py in data folder to generate dataset.

Train

Firstly, train the style encoder:

python train_stylish.py

Secondly, fetch the style embedding for each sample in the train set:

python fetch_embedding.py

Lastly, train the curve encoder and mapping network:

python train_enhancer.py

Test

Just run:

python test.py

Testing LPIPS requires about 10 GB GPU memory, and if an OOM occurs, replace the following lines

lpips_val = loss_fn_alex(output * 2 - 1, target_img * 2 - 1).item()

with

lpips_val = 0

Notes

Due to licenses, we are unable to release part of the source code. This repository provides a pure python implementation for research use. There are some differences between the repository and the paper as follows:

  1. The repository uses a ResNet-18 w/o BN as the curve encoder's backbone, and the paper uses a more lightweight model.
  2. The paper uses CUDA to implement the color transform function, and the repository uses torch.gather to implement it.
  3. The repository removes some tricks used in training lightweight models.

Overall, this repository can achieve higher performance, but will be slightly slower.

Citation

If you find this work useful for your research, please cite our paper:

@inproceedings{song2021starenhancer,
  title={StarEnhancer: Learning Real-Time and Style-Aware Image Enhancement},
  author={Song, Yuda and Qian, Hui and Du, Xin},
  booktitle={Proceedings of the IEEE/CVF International Conference on Computer Vision},
  pages={4126--4135},
  year={2021}
}

starenhancer's People

Contributors

idkiro avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

starenhancer's Issues

The results are not the same as the paper

I am the author.

Some peers have emailed me asking about the performance of the open source model that does not agree with the results in the paper.
As stated in the README, the model is not the model of the paper, but the performance is similar.
The exact result should be:
PSNR: 25.41, SSIM: 0.942, LPIPS: 0.085

If you find that your result is not this, then it may be that the JPEG codec is different, which is related to the version of opencv and how it is installed.

You can uninstall your opencv (either with pip or conda) and reinstall it using pip (it must be pip, because conda installs a different JPEG codec):

pip install opencv-python==4.5.5.62​

One question about the code under the setting of sigle-style enhancement

I am testing your codes on single-style enhancement. However, in line 103-104 of the file 'loader.py', I find you randomly use images of different styles as the source image and target image during the training and validation stage, which may cause the optimization process unstable. It is better to fix the source style and target style?

Multi-style, unpaired setting

您好,在多风格非配对图场景,能否交换source和target的位置,并将得到的output_A和output_B进一步经过enhancer,得到recover_A和recover_B。最后计算l1_loss(source, recover_A)和l1_loss(target, recover_B)及Triplet_loss(output_A,target, source) 和 Triplet_loss(output_B,source,target)

def train(train_loader, mapping, enhancer, criterion, optimizer):
    losses = AverageMeter()
    criterionTriplet = torch.nn.TripletMarginLoss(margin=1.0, p=2)
    FEModel = Feature_Extract_Model().cuda()

    mapping.train()
    enhancer.train()

    for (source_img, source_center, target_img, target_center) in train_loader:
        source_img = source_img.cuda(non_blocking=True)
        source_center = source_center.cuda(non_blocking=True)
        target_img = target_img.cuda(non_blocking=True)
        target_center = target_center.cuda(non_blocking=True)

        style_A = mapping(source_center)
        style_B = mapping(target_center)

        output_A = enhancer(source_img, style_A, style_B)
        output_B = enhancer(target_img, style_B, style_A)
        recoverA = enhancer(output_A, style_B, style_A)
        recoverB = enhancer(output_B, style_A, style_B)

        source_img_feature = FEModel(source_img)
        target_img_feature = FEModel(target_img)
        output_A_feature = FEModel(output_A)
        output_B_feature = FEModel(output_B)

        loss_l1 = criterion(recoverA, source_img) + criterion(recoverB, target_img)
        loss_triplet = criterionTriplet(output_B_feature, source_img_feature, target_img_feature) + \
                       criterionTriplet(output_A_feature, target_img_feature, source_img_feature)
        loss = loss_l1 + loss_triplet

        losses.update(loss.item(), args.t_batch_size)

        optimizer.zero_grad()
        loss.backward()
        optimizer.step()

    return losses.avg

About pretrain model

提供的pretrain模型可以直接跑出enhancer的效果吗,还是说必须先加载进来训练呢,我发现直接加载pretrain的模型跑出的图片没有什么效果。

Questions about dataset preparation

您好,我想用您的工程跑一下自己的数据,现在有输入,输出一组数据对,训练数据里面A-E剩下的4种效果是怎样生成的呢,这些目标效果数据能否是非成对的呢?如果只有一种风格,能否A-E目标效果都拷贝成一样的数据呢,在train_enhancer.py所训练的单风格脚本是需要embeddings.npy文件,这个文件在单风格训练时是必须的吗

Dataset processing

你好,我在您提供的fivek.lrcat没找到 DeepUPE issue里的"(default) input with ExpertC"。请问单风格实验的输入是下图中的“InputAsShotZeroed”还是“(Q)InputZeroed with ExpertC WhiteBalance”
image

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.