# Team: **play1play**

for 'Night Photography Rendering Challenge'

This repo contains the source code of [Night Photography Rendering Challenge 2024](https://nightimaging.org/).

## How to run
### Run without Docker
- Install python >= 3.9
- Install the required packages: `pip install -r requirements.txt`
- Put the test images in the `data` folder or specify the input image path with `-p` option.
- Run the script: 
```
python run.py -p <input_image_path> -o <output_image_path>
```
- The output images will be saved in the `output` folder or specifiy the output path with `-o` option.

### Run with Docker
- Build the docker image from beginning (optional): 
```
docker build -t play1play .
```
- Run the docker container with gpu on linux:
```
docker run -it --rm --gpus=all -v $(pwd)/data:/data play1play ./run.sh
```
`Do not forget to to --gpus flag, our model requires GPU to run.`

## Update
*2024.3.21:*

Final version v3.0 is released for 3rd validation!

Key features:
- Utilize the patch-based and calibration-based white-balance algorithm to improve the image quality.
- Modify the resizing strategy to improve the image quality.

*2024.3.16:*

Release v2.0 for 3rd validation!

Key features:
- Increase the overall saturation and brightness of the image.
- Add more contrast to the image.
- Add more dynamic range to the image.

Algorithm changes:
- Add luma shading correction (LSC) module
- Add auto-contrast module (dynamic gamma)
- LSC, LTM, auto-contrast module can dynamiclly adjust the parameters based on the camera gain from the metadata.
- Add another white-balance process at the end of the pipeline to further improve the image quality.

Key algorithm parameter explanation:
- k_th: defines the threshold for the noise level, higher means tolerant to noise, lower means more sensitive to noise. For this sensor, default is 2.5e-3. `Note that this paramerts are shared by all the modules, and hence defined as the member varibale in RawProcessingPipelineDemo class.`
- s of local_tone_mapping: defines how to apply the gain map to different image channels. Higher means more saturated, lower means less saturated. Default is 0.7. `Currently, s is automatically adjusted based on the camera gain from the metadata.`

*2024.3.7:*

release v1.0 for 3rd validation!

----

## Version-1

- TMO-ratio50

-----

## Version-2

- TMO: ratio50

- Gamma: 1.5

- Contrast:[low=2,high=0.2]

- Post-AWB: GI