https://github.com/pythonnut/photo-deblur
Experiments in unblurring photographs
https://github.com/pythonnut/photo-deblur
Last synced: 6 months ago
JSON representation
Experiments in unblurring photographs
- Host: GitHub
- URL: https://github.com/pythonnut/photo-deblur
- Owner: PythonNut
- License: mit
- Created: 2018-04-15T18:24:35.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-04-18T23:27:05.000Z (over 7 years ago)
- Last Synced: 2025-07-09T00:59:51.443Z (6 months ago)
- Language: Python
- Size: 23.4 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Photo deblur
Experiments in correcting the focus of photographs.
Done as part of Spring 2018 Camera Lab at Harvey Mudd College.
## Dependencies
* [Python 3](https://www.python.org/)
* [Tcl/Tk](http://tcl.sourceforge.net/)
* [Hugin](http://hugin.sourceforge.net/)
* [LLVM](https://llvm.org/)
### Setup on macOS
Install command-line tools:
$ xcode-select --install
Install [Homebrew](https://brew.sh/):
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Install Python:
$ brew install python
Install Python dependencies in a virtual environment:
$ python -m venv ~/.virtualenvs/photo-deblur
$ source ~/.virtualenvs/photo-deblur/bin/activate
$ pip install -r requirements.txt
Install Hugin:
$ brew cask install hugin
$ ln -s /Applications/Hugin/Hugin.app/Contents/MacOS/align_image_stack /usr/local/bin/
Install up-to-date LLVM:
$ brew install llvm
Build Richardson-Lucy module:
$ cd Image-Cases-Studies && python setup.py build_ext --inplace
### Setup on Arch Linux
Install Python:
$ sudo pacman -Sy python
Install Python dependencies in a virtual environment:
$ python -m venv ~/.virtualenvs/photo-deblur
$ source ~/.virtualenvs/photo-deblur/bin/activate
$ pip install -r requirements.txt
Install Tcl/Tk:
$ sudo pacman -Sy tk
Install Hugin:
$ sudo pacman -Sy hugin
Build Richardson-Lucy module:
$ cd Image-Cases-Studies && python setup.py build_ext --inplace
## Usage
Run all the experiments:
$ make
(Refer to `Makefile` for more advanced usage.)
## Further reading
* http://yuzhikov.com/articles/BlurredImagesRestoration1.htm
* http://yuzhikov.com/articles/BlurredImagesRestoration2.htm
* http://aishack.in/tutorials/image-convolution-examples/
* http://www.naturefocused.com/articles/photography-image-processing-kernel.html
* http://setosa.io/ev/image-kernels/
* http://www.robots.ox.ac.uk/~az/lectures/ia/lect2.pdf
* https://github.com/aurelienpierre/Image-Cases-Studies