• Stars
    star
    304
  • Rank 137,274 (Top 3 %)
  • Language
    Python
  • License
    MIT License
  • Created over 2 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

[IEEE TIP] Vision Transformers for Single Image Dehazing

Vision Transformers for Single Image Dehazing

Demo Paper Paper2 GoogleDrive BaiduPan

Abstract: Image dehazing is a representative low-level vision task that estimates latent haze-free images from hazy images. In recent years, convolutional neural network-based methods have dominated image dehazing. However, vision Transformers, which has recently made a breakthrough in high-level vision tasks, has not brought new dimensions to image dehazing. We start with the popular Swin Transformer and find that several of its key designs are unsuitable for image dehazing. To this end, we propose DehazeFormer, which consists of various improvements, such as the modified normalization layer, activation function, and spatial information aggregation scheme. We train multiple variants of DehazeFormer on various datasets to demonstrate its effectiveness. Specifically, on the most frequently used SOTS indoor set, our small model outperforms FFA-Net with only 25% #Param and 5% computational cost. To the best of our knowledge, our large model is the first method with the PSNR over 40 dB on the SOTS indoor set, dramatically outperforming the previous state-of-the-art methods. We also collect a large-scale realistic remote sensing dehazing dataset for evaluating the method's capability to remove highly non-homogeneous haze.

DehazeFormer

News

Preparation

Install

We test the code on PyTorch 1.10.2 + CUDA 11.3 + cuDNN 8.2.0.

  1. Create a new conda environment
conda create -n pt1102 python=3.7
conda activate pt1102
  1. Install dependencies
conda install pytorch=1.10.2 torchvision torchaudio cudatoolkit=11.3 -c pytorch
pip install -r requirements.txt

Download

You can download the pretrained models and datasets on GoogleDrive or BaiduPan (gtuw).

Currently, we only provide gamma-corrected RGB images of our RS-Haze dataset.

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

โ”ฌโ”€ save_models
โ”‚   โ”œโ”€ indoor
โ”‚   โ”‚   โ”œโ”€ dehazeformer-b.pth
โ”‚   โ”‚   โ””โ”€ ... (model name)
โ”‚   โ””โ”€ ... (exp name)
โ””โ”€ data
    โ”œโ”€ RESIDE-IN
    โ”‚   โ”œโ”€ train
    โ”‚   โ”‚   โ”œโ”€ GT
    โ”‚   โ”‚   โ”‚   โ””โ”€ ... (image filename)
    โ”‚   โ”‚   โ””โ”€ hazy
    โ”‚   โ”‚       โ””โ”€ ... (corresponds to the former)
    โ”‚   โ””โ”€ test
    โ”‚       โ””โ”€ ...
    โ””โ”€ ... (dataset name)

Training and Evaluation

In order to align the folder structure of each dataset, we rearrange the original dataset.

Train

You can modify the training settings for each experiment in the configs folder. Then run the following script to train the model:

python train.py --model (model name) --dataset (dataset name) --exp (exp name)

For example, we train the DehazeFormer-B on the ITS:

python train.py --model dehazeformer-b --dataset RESIDE-IN --exp indoor

TensorBoard will record the loss and evaluation performance during training.

Test

Run the following script to test the trained model:

python test.py --model (model name) --dataset (dataset name) --exp (exp name)

For example, we test the DehazeFormer-B on the SOTS indoor set:

python test.py --model dehazeformer-b --dataset RESIDE-IN --exp indoor

Main test scripts can be found in run.sh.

Notes

  1. Send email to [email protected] if you have critical issues to be addressed.
  2. Test results using opencv installed with conda are lower than pypi since they call different JPEG image codecs.
  3. Because the synthetic dataset is not realistic enough, the trained models may not work well on real hazy images.
  4. Refer to two-branch and modify the hyperparameters to train the model on real datasets.
  5. Use the mixed dataset for training to obtain good dehazing results for real-world hazy images.
  6. The code for the synthetic dataset method and MS images will be released by another author.

Citation

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

@article{song2023vision,
  title={Vision Transformers for Single Image Dehazing},
  author={Song, Yuda and He, Zhuqing and Qian, Hui and Du, Xin},
  journal={IEEE Transactions on Image Processing},
  year={2023},
  volume={32},
  pages={1927-1941}
}