PyTorch Lightning Implementations of Recent Low-Light Image Enhancement !
Project description
Light Side of the Night
Low-Light Image Enhancement
TABLE OF CONTENTS
About The Light Side
Light Side is an low-light image enhancement library that consist state-of-the-art deep learning methods. The light side of the Force is referenced. The aim is to create a light structure that will find the Light Side of the Night
.
The light side of the Force, also known as Ashla, was one of two methods of using the Force. The light side was aligned with calmness, peace, and passiveness, and was used only for knowledge and defense. The Jedi were notable practitioners of the light, being selfless servants of the will of the Force, and their enemies, the Sith followed the dark side of the Force.
Source: Wookieepedia
Low-light image enhancement aims at improving the perception or interpretability of an image captured in an environment with poor illumination.
Source: paperswithcode
Prerequisites
Before you begin, ensure you have met the following requirements:
requirement | version |
---|---|
imageio | ~=2.15.0 |
numpy | ~=1.22.0 |
pytorch_lightning | ~=1.7.0 |
scikit-learn | ~=1.0.2 |
torch | ~=1.9.1 |
Installation
To install Light Side, follow these steps:
From Pypi
pip install light_side
From Source
git clone https://github.com/canturan10/light_side.git
cd light_side
pip install .
From Source For Development
git clone https://github.com/canturan10/light_side.git
cd light_side
pip install -e ".[all]"
Usage Examples
import imageio
import light_side as ls
img = imageio.imread("test.jpg")
model = ls.Enhancer.from_pretrained("model_config_dataset")
model.eval()
results = model.predict(img)
APIs
- Available Models
- Available Versions for a Spesific Model
- Latest Version for a Spesific Model
- Pretrained Model
- Model with Random Weight Initialization
- Pretrained Arch Model
- Arch Model with Random Weight Initialization
For more information, please refer to the APIs
Architectures
For more information, please refer to the Architectures
Datasets
For more information, please refer to the Datasets
Deployments
For more information, please refer to the Deployment
Training
To training, follow these steps:
For installing Light Side, please refer to the Installation.
python training/zerodce_training.py
For optional arguments,
python training/zerodce_training.py --help
Tests
During development, you might like to have tests run.
Install dependencies
pip install -e ".[test]"
Linting Tests
pytest light_side --pylint --pylint-error-types=EF
Document Tests
pytest light_side --doctest-modules
Coverage Tests
pytest --doctest-modules --cov light_side --cov-report term
Contributing
To contribute to Light Side
, follow these steps:
- Fork this repository.
- Create a branch:
git checkout -b <branch_name>
. - Make your changes and commit them:
git commit -m '<commit_message>'
- Push to the original branch:
git push origin
- Create the pull request.
Alternatively see the GitHub
documentation on creating a pull request.
Contributors
Oğuzcan Turan |
You ? |
Contact
If you want to contact me you can reach me at can.turan.10@gmail.com.
License
This project is licensed under MIT
license. See LICENSE
for more information.
References
The references used in the development of the project are as follows.
Citations
Click to expand!
@misc{Turan_satellighte,
author = {Turan, Oguzcan},
title = {{satellighte}},
url = {https://github.com/canturan10/satellighte}
}
@article{DBLP:journals/corr/abs-2001-06826,
author = {Chunle Guo and
Chongyi Li and
Jichang Guo and
Chen Change Loy and
Junhui Hou and
Sam Kwong and
Runmin Cong},
title = {Zero-Reference Deep Curve Estimation for Low-Light Image Enhancement},
journal = {CoRR},
volume = {abs/2001.06826},
year = {2020},
url = {https://arxiv.org/abs/2001.06826},
eprinttype = {arXiv},
eprint = {2001.06826},
timestamp = {Sat, 23 Jan 2021 01:20:17 +0100},
biburl = {https://dblp.org/rec/journals/corr/abs-2001-06826.bib},
bibsource = {dblp computer science bibliography, https://dblp.org}
}
Give a ⭐️ if this project helped you!
This readme file is made using the readme-template
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for light_side-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 35c8ad7dba0d80f7538712bef0a6cda762ea3207c26679461b041fd06b516445 |
|
MD5 | 5bd0498d844a82292fac1c56404c2375 |
|
BLAKE2b-256 | 987e7991d7e870f456d58df9344c2884979e9128f2de2ad2f951929b7fec7871 |