Awesome

<p align=center> A Hybrid Transformer-Mamba Network for Single Image Deraining</p>

<img src="assets/TransMamba.png" width="385">
Network structure

</div>

A Hybrid Transformer-Mamba Network for Single Image Deraining<br> Shangquan Sun, Wenqi Ren, Juxiang Zhou, Jianhou Gan, Rui Wang, Xiaochun Cao<br>

<details> <summary><strong>Abstract</strong> (click to expand) </summary> Existing deraining Transformers employ self-attention mechanisms with fixed-range windows or along channel dimensions, limiting the exploitation of non-local receptive fields. In response to this issue, we introduce a novel dual-branch hybrid Transformer-Mamba network, denoted as TransMamba, aimed at effectively capturing long-range rain-related dependencies. Based on the prior of distinct spectral-domain features of rain degradation and background, we design a spectral-banded Transformer blocks on the first branch. Self-attention is executed within the combination of the spectral-domain channel dimension to improve the ability of modeling long-range dependencies. To enhance frequency-specific information, we present a spectral enhanced feed-forward module that aggregates features in the spectral domain. In the second branch, Mamba layers are equipped with cascaded bidirectional state space model modules to additionally capture the modeling of both local and global information. At each stage of both the encoder and decoder, we perform channel-wise concatenation of dual-branch features and achieve feature fusion through channel reduction, enabling more effective integration of the multi-scale information from the Transformer and Mamba branches. To better reconstruct innate signal-level relations within clean images, we also develop a spectral coherence loss. Extensive experiments on diverse datasets and real-world images demonstrate the superiority of our method compared against the state-of-the-art approaches. </details>

:mega: Citation

If you use TransMamba, please consider citing:

@article{sun2024hybrid,
  title={A Hybrid Transformer-Mamba Network for Single Image Deraining},
  author={Sun, Shangquan and Ren, Wenqi and Zhou, Juxiang and Gan, Jianhou and Wang, Rui and Cao, Xiaochun},
  journal={arXiv preprint arXiv:2409.00410},
  year={2024}
}

:rocket: News

2024.08.31: TransMamba is released on Github.

🧩 Dataset Preparation

The download links are from NeRD

Datasets	Download Link
Rain200L	Baidu Netdisk (s2yx)
Rain200H	Baidu Netdisk (z9br)
DID-Data	Baidu Netdisk (5luo)
DDN-Data	Baidu Netdisk (ldzo)
SPA-Data	Baidu Netdisk (yjow)

:gear: Installation

See INSTALL.md for the installation of dependencies required to run TransMamba.

:hammer_and_wrench: Training

Download Datasets.
Modify the configurations of dataroot_gt and dataroot_lq for train, and val in Deraining/Options/Deraining_TransMamba_[DATASET].yml
To train TransMamba with default settings, run

cd TransMamba
./train.sh Deraining/Options/Deraining_TransMamba.yml 4321

Note: The above training script uses 4 GPUs by default. To use any other settings, for example 8 GPUs, modify CUDA_VISIBLE_DEVICES=0,1,2,3,4,5,6,7 and --nproc_per_node=8 in TransMamba/train.sh and num_gpu: 8 Deraining/Options/Deraining_TransMamba_[DATASET].yml.

:balance_scale: Evaluation

cd Deraining
Download the pre-trained models and place it in ./pretrained_models/
Download test datasets from each of them, i.e., Rain200H, DDN-Data, and RainDrop.
Test with the replaced argument --input_dir [INPUT_FOLDER] and [DATASET]

python test.py --input_dir [INPUT_FOLDER] --result_dir result/ --weights pretrained_models/TransMamba_[DATASET].pth --yaml_file Options/Deraining_TransMamba_[DATASET].yml

Compute PSNR and SSIM by

python compute_psnr.py --path1 [GT-PATH] --path2 [Restored-PATH]

:balance_scale: Demo

cd Deraining
Download the pre-trained models and place it in ./pretrained_models/
Test with the replaced argument --input_dir [INPUT_FOLDER]

python test.py --input_dir [INPUT_FOLDER] --result_dir result/ --weights pretrained_models/TransMamba_[DATASET].pth --yaml_file Options/Deraining_TransMamba_[DATASET].yml

:mailbox_with_mail: Contact

If you have any question, please contact shangquansun@gmail.com

Acknowledgment: This code is based on the Mamba, NeRD, Histoformer, Restormer, BasicSR toolbox and HINet. Thanks for their works.