# GMAN_Net_Haze_Removal

**Repository Path**: david12/GMAN_Net_Haze_Removal

## Basic Information

- **Project Name**: GMAN_Net_Haze_Removal
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-04-27
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GMAN(Jan, 2018 - June, 2018 & Dec, 2018 - Now)
### Introduction
GMAN is a awesome Convolutional neural network purposed on haze removal. It is a completely end-to-end dehaze system so the input to the system is hazed rgb images and the output of the system is the clear images that processed by the system. The results can be found in the [Results](https://github.com/Seanforfun/GMAN_Net_Haze_Removal/tree/master/Results) column, where lists our evaluation results on SOTS evaluation dataset. There lists 500 images for indoor test and 500 images for outdoor test saparately, in each file, we can also find a log.txt file showing the psnr and ssim for each images.

| Dateset | PSNR(dB) | SSIM | Model Path | Link to result |
| :-: | :-: | :-: |  :-: | :-: |
| SOTS outdoor | 28.474217 | 0.944434 | [click me](https://github.com/Seanforfun/GMAN_Net_Haze_Removal/tree/master/Results/models/outdoor) | [click me](https://github.com/Seanforfun/GMAN_Net_Haze_Removal/tree/master/Results/SOTSOutdoor) |
| SOTS indoor | 27.934801 | 0.896512 | [click me](https://github.com/Seanforfun/GMAN_Net_Haze_Removal/tree/master/Results/models/indoor) | [click me](https://github.com/Seanforfun/GMAN_Net_Haze_Removal/tree/master/Results/SOTSIndoor) |

![Imgur](https://i.imgur.com/HfPpj6Q.png)

## How to use?
1. Step 1:
    * You need to install all packages required by the program, such as tensorflow(GPU version), numpy etc.
    * You need to download current repository into your local environment and extract it.
2. Step 2:
    * Go to your local file and enter the setup.sh file. Change the line 14, "PROGRAM_ROOT_PATH=''" to the path you want.
    * Run ```sh setup.sh```, it will automatically create the directories for running the program

### Evaluate your own image
3. Step 3:
    * Move the hazed images to (PROGRAM_ROOT_PATH)/HazeImages/TestImages.
    * If you have ground truth images to compare with the pictures processed by the net, move them to (PROGRAM_ROOT_PATH)/ClearImages/TestImages.
4. Step 4:
    * Copy the model from (DOWNLOAD FILE)/Results/models/(outdoor or indoor) to (PROGRAM_ROOT_PATH)/DeHazeNetModel
5. Step 5:
    * If you want to compare the result with groundtruth, you just need to run the program by using ```python3 gman_eval.py```.
    * If you don't have ground truth, you can can run the program by using ```python3 gman_eval.py --eval_only_haze=True```.
6. Step 6:
    * You results are in (PROGRAM_ROOT_PATH)/ClearResultImages.

## Demonstration
Only listed several examples, more results can be found in my [github](https://github.com/Seanforfun/GMAN_Net_Haze_Removal/tree/master/Results).
#### Outdoor
<table>
	<tr>
		<th>Hazy</th>
		<th>Groundtruth</th>
		<th>Our result</th>	
	</tr>
	<tr>
		<th><img src="https://i.imgur.com/8S6cpRe.jpg"/></th>		
		<th><img src="https://i.imgur.com/fUhQuld.png"/></th>
		<th><img src="https://i.imgur.com/jOLhygU.jpg"/></th>
	</tr>
	<tr>
		<th><img src="https://i.imgur.com/deNcv4O.jpg"/></th>		
		<th><img src="https://i.imgur.com/L66qRbw.png"/></th>
		<th><img src="https://i.imgur.com/miDdMgk.jpg"/></th>
	</tr>
	<tr>
		<th><img src="https://i.imgur.com/rFTGcVD.jpg"/></th>		
		<th><img src="https://i.imgur.com/aSmMOJE.png"/></th>
		<th><img src="https://i.imgur.com/r1YPHym.jpg"/></th>
	</tr>
	<tr>
		<th><img src="https://i.imgur.com/iBE5sGw.jpg"/></th>		
		<th><img src="https://i.imgur.com/u6HY6qE.png"/></th>
		<th><img src="https://i.imgur.com/x2Uu3Tc.jpg"/></th>
	</tr>
	<tr>
		<th><img src="https://i.imgur.com/cVtaJnm.jpg"/></th>		
		<th><img src="https://i.imgur.com/4QKZdHa.png"/></th>
		<th><img src="https://i.imgur.com/wQ6SmiQ.jpg"/></th>
	</tr>
</table>

#### Indoor
<table>
	<tr>
		<th>Hazy</th>
		<th>Groundtruth</th>
		<th>Our result</th>	
	</tr>
	<tr>
		<th><img src="https://i.imgur.com/81MUWBh.png"/></th>		
		<th><img src="https://i.imgur.com/bsqSWNC.png"/></th>
		<th><img src="https://i.imgur.com/pBhsVG8.jpg"/></th>
	</tr>
	<tr>
		<th><img src="https://i.imgur.com/UrDTN2G.png"/></th>		
		<th><img src="https://i.imgur.com/75yuyRw.png"/></th>
		<th><img src="https://i.imgur.com/Y7TbUOR.jpg"/></th>
	</tr>
	<tr>
		<th><img src="https://i.imgur.com/rx5jrpd.png"/></th>		
		<th><img src="https://i.imgur.com/7cPB8Wg.png"/></th>
		<th><img src="https://i.imgur.com/fFIwaMG.jpg"/></th>
	</tr>
	<tr>
		<th><img src="https://i.imgur.com/9bWE6zj.png"/></th>		
		<th><img src="https://i.imgur.com/fbAWMTg.png"/></th>
		<th><img src="https://i.imgur.com/r6GiyXj.jpg"/></th>
	</tr>	
</table>

### Citation
Please cite the paper if you are using this project.
```
@article{liu2019single,
  title={Single Image Dehazing with a Generic Model-Agnostic Convolutional Neural Network},
  author={Liu, Zheng and Xiao, Botao and Alrabeiah, Muhammad and Wang, Keyan and Chen, Jun},
  journal={IEEE Signal Processing Letters},
  volume={26},
  number={6},
  pages={833--837},
  year={2019},
  publisher={IEEE}
}
```

### More
More of my Deep learning projects, please have a look at my website.[Deep Learning Projects](https://seanforfun.github.io/DeepLearning/)