Welcome to imreg_dft’s documentation!¶
imreg_dft implements DFT[*] -based technique for translation, rotation and scale-invariant image registration.
In plain language,
imreg_dft implements means of calculating translation, rotation and scale variation between two images.
It doesn’t work with those images directly, but it works with their spectrum, using the log-polar transformation.
The algorithm is described in  and possibly also in  and .
|[*]||DFT stands for Discrete Fourier Transform. Usually the acronym FFT (Fast Fourier Transform) is used in this context, but this is incorrect. DFT is the name of the operation, whereas FFT is just one of possible algorithms that can be used to calculate it.|
requirements.txt file in the project’s root for the exact specification.
Generally, you will need
scipy for the core algorithm functionality.
Optionally, you may need:
pillowfor loading data from image files,
matplotlibfor displaying image output,
pyfftwfor better performance.
Head for the corresponding section of the documentation. Note that you can generate the documentation yourself!
- Install the package by running
python setup.py installin the project root.
- Install packages that are required for the documentation to compile (see the
- Go to the
docdirectory and run
make htmlthere. The documentation should appear in the
_buildsubfolder, so you may open
_build/html/index.htmlwith your web browser to see it.
The API and algorithms are quite good, but help is appreciated.
imreg_dft uses semantic versioning, so backward compatibility of any kind will not break across versions with the same major version number.
imreg_dft is based on the code by Christoph Gohlke.
|||An FFT-based technique for translation, rotation and scale-invariant image registration. BS Reddy, BN Chatterji. IEEE Transactions on Image Processing, 5, 1266-1271, 1996|
|||An IDL/ENVI implementation of the FFT-based algorithm for automatic image registration. H Xiea, N Hicksa, GR Kellera, H Huangb, V Kreinovich. Computers & Geosciences, 29, 1045-1055, 2003.|
|||Image Registration Using Adaptive Polar Transform. R Matungka, YF Zheng, RL Ewing. IEEE Transactions on Image Processing, 18(10), 2009.|
- Quickstart guide
- Command-line tool overview
- Advanced command-line
- Utility scripts
- Use as a Python module
- Conceptual-level documentation
- Developer reference
- User-centric changelog