Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Image registration utility using algorithms based on discrete Fourier transform (DFT, FFT)

Project Description

imreg_dft is your first-choice Python image registration utility. In plain language, it implements means of guessing translation, rotation and scale variation between two images. The name comes from the fact that it doesn’t work with those images directly, but it works with their spectrum (DFT using FFT), and its log-polar transformation [1], hence the _dft after imreg.

Basically, if you want to align two images that have different scale and are rotated and shifted against each other, imreg_dft is the tool you want to check out. Get started in five minutes and see how it works for you!

  • Brno University of Technology, Brno, Czech Republic
  • Laboratory for Fluorescence Dynamics, University of California, Irvine
  • 2014-2015, Matěj Týč
  • 2011-2014, Christoph Gohlke


imreg_dft is free software, i.e. both free of charge (so it is free as free beer) and you as a user are granted four basic freedoms (so it is also free as free speech).

Generally, you will need numpy and scipy for the algorithm functionality and matplotlib for plotting. For the command-line tool, reading images is useful, so make sure you have pillow (or PIL, which is deprecated).


Check the documentation on readthedocs.ort (bleeding-edge) or (with images). Or even better, generate the documentation yourself!

  1. Install the package by running python install in the project root.
  2. Install packages that are required for the documentation to compile (see the requirements_docs.txt file.
  3. Go to the doc directory and run make html there. The documentation should appear in the _build subfolder, so you may open _build/html/index.html with your web browser to see it.


imreg_dft is based on the code by Christoph Gohlke.


[1]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
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
imreg_dft-2.0.0.tar.gz (101.6 kB) Copy SHA256 Checksum SHA256 Source Jun 18, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting