Data

Tools

Indexes

Applications

Experiments

Open Source Science

https://github.com/cgohlke/imreg

FFT based image registration.

https://github.com/cgohlke/imreg

Science Score: 23.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ○
    .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ✓
    Committers with academic emails
    1 of 2 committers (50.0%) from academic institutions
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (9.0%) to scientific vocabulary

Keywords

image-registration python
Last synced: 6 months ago · JSON representation

Repository

FFT based image registration.

Basic Info
Statistics
  • Stars: 45
  • Watchers: 5
  • Forks: 7
  • Open Issues: 0
  • Releases: 0
Topics
image-registration python
Created about 6 years ago · Last pushed about 1 year ago
Metadata Files
Readme License

README.rst 

..
  This file is generated by setup.py

FFT based image registration
============================

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):

- `CPython `_ 3.10.11, 3.11.9, 3.12.8, 3.13.1 64-bit
- `NumPy `_ 2.1.3
- `Scipy `_ 1.14.1
- `Matplotlib 3.10.0 `_
  (optional for plotting)

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

.. code-block:: python

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

.. code-block:: python

    >>> im0 = imread('t350380ori')
    >>> im1 = imread('t350380shf')
    >>> t0, t1 = translation(im0, im1)
    >>> t0, t1
    (20, 50)

Owner

  • Name: Christoph Gohlke
  • Login: cgohlke
  • Kind: user
  • Location: Irvine, California

GitHub Events

Total
  • Issues event: 2
  • Watch event: 7
  • Issue comment event: 4
  • Push event: 1
  • Fork event: 1
  • Create event: 1
Last Year
  • Issues event: 2
  • Watch event: 7
  • Issue comment event: 4
  • Push event: 1
  • Fork event: 1
  • Create event: 1

Committers

Last synced: over 1 year ago

All Time
  • Total Commits: 30
  • Total Committers: 2
  • Avg Commits per committer: 15.0
  • Development Distribution Score (DDS): 0.467
Past Year
  • Commits: 9
  • Committers: 1
  • Avg Commits per committer: 9.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Christoph Gohlke c****e@u****u 16
Christoph Gohlke c****e@c****m 14
Committer Domains (Top 20 + Academic)
cgohlke.com: 1 uci.edu: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 1
  • Total pull requests: 0
  • Average time to close issues: 22 minutes
  • Average time to close pull requests: N/A
  • Total issue authors: 1
  • Total pull request authors: 0
  • Average comments per issue: 3.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 0
  • Average time to close issues: 22 minutes
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 3.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • GeneralAccess (1)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 258 last-month
  • Total dependent packages: 2
  • Total dependent repositories: 1
  • Total versions: 7
  • Total maintainers: 1
pypi.org: imreg

FFT based image registration

  • Versions: 7
  • Dependent Packages: 2
  • Dependent Repositories: 1
  • Downloads: 258 Last month
Rankings
Dependent packages count: 4.7%
Stargazers count: 12.9%
Forks count: 14.2%
Average: 15.3%
Dependent repos count: 21.8%
Downloads: 22.9%
Maintainers (1)
cgohlke
Last synced: 6 months ago

Dependencies

setup.py pypi
  • numpy >=1.15.1
  • scipy >=1.4