| # 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 | |