Skip to main content

FFT based image registration

Project description

Imreg is a Python library that implements an FFT-based technique for translation, rotation and scale-invariant image registration [1].

Author:

Christoph Gohlke

License:

BSD 3-Clause

Version:

2025.1.1

Quickstart

Install the imreg package and all dependencies from the Python Package Index:

python -m pip install -U imreg

See Examples for using the programming interface.

Source code and support are available on GitHub.

Requirements

This revision was tested with the following requirements and dependencies (other versions may work):

Revisions

2025.1.1

  • Drop support for Python 3.9, support Python 3.13.

2024.5.24

  • Support NumPy 2.

  • Fix docstring examples not correctly rendered on GitHub.

2024.1.2

  • Add type hints.

  • Drop support for Python 3.8 and numpy < 1.23 (NEP29).

2022.9.27

  • Fix scipy.ndimage DeprecationWarning.

Notes

Imreg is no longer being actively developed.

This implementation is mainly for educational purposes.

An improved version is being developed at https://github.com/matejak/imreg_dft.

References

  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

  2. 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.

  3. Image Registration Using Adaptive Polar Transform. R Matungka, YF Zheng, RL Ewing. IEEE Transactions on Image Processing, 18(10), 2009.

Examples

>>> im0 = imread('t400')
>>> im1 = imread('Tr19s1.3')
>>> im2, scale, angle, (t0, t1) = similarity(im0, im1)
>>> imshow(im0, im1, im2)
>>> im0 = imread('t350380ori')
>>> im1 = imread('t350380shf')
>>> t0, t1 = translation(im0, im1)
>>> t0, t1
(20, 50)

Project details


Download files

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

Source Distribution

imreg-2025.1.1.tar.gz (7.2 kB view details)

Uploaded Source

Built Distribution

imreg-2025.1.1-py3-none-any.whl (8.1 kB view details)

Uploaded Python 3

File details

Details for the file imreg-2025.1.1.tar.gz.

File metadata

  • Download URL: imreg-2025.1.1.tar.gz
  • Upload date:
  • Size: 7.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for imreg-2025.1.1.tar.gz
Algorithm Hash digest
SHA256 3f62e08f9b220e7944d914f829f2d0bae6e09a4406d7af842e5ea08b50f008ec
MD5 b85ed14bd96ad49ff17e1a736037db16
BLAKE2b-256 5477e05c1f914761b04b2835420adbcd8ae253b5cab096d6ee73a3f4085d17ef

See more details on using hashes here.

File details

Details for the file imreg-2025.1.1-py3-none-any.whl.

File metadata

  • Download URL: imreg-2025.1.1-py3-none-any.whl
  • Upload date:
  • Size: 8.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for imreg-2025.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c186631864d9819dfdef28c5cbff240e37968c2a4edf7a3117363627dd8481a6
MD5 bccfab5136b456cc66878decd1454956
BLAKE2b-256 3fe99faa70da663c29e90dd78f5f1aa1f2632ac50db9a5ef16668e1f010f0295

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page