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 <https://www.cgohlke.com>`_
:License: BSD 3-Clause
:Version: 2024.5.24
Quickstart
----------
Install the imreg package and all dependencies from the
`Python Package Index <https://pypi.org/project/imreg/>`_::
python -m pip install -U imreg
See `Examples`_ for using the programming interface.
Source code and support are available on
`GitHub <https://github.com/cgohlke/imreg>`_.
Requirements
------------
This revision was tested with the following requirements and dependencies
(other versions may work):
- `CPython <https://www.python.org>`_ 3.9.13, 3.10.11, 3.11.9, 3.12.3
- `NumPy <https://pypi.org/project/numpy/>`_ 1.26.4
- `Scipy <https://pypi.org/project/scipy>`_ 1.12.0
- `Matplotlib 3.8.4 <https://pypi.org/project/matplotlib>`_
(optional for plotting)
Revisions
---------
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)
Raw data
{
"_id": null,
"home_page": "https://www.cgohlke.com",
"name": "imreg",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Christoph Gohlke",
"author_email": "cgohlke@cgohlke.com",
"download_url": "https://files.pythonhosted.org/packages/e0/8f/ca9b98344705ddcb0fa88506e06887774434c44a69b2bc0097c3a56998a4/imreg-2024.5.24.tar.gz",
"platform": "any",
"description": "FFT based image registration\r\n============================\r\n\r\nImreg is a Python library that implements an FFT-based technique for\r\ntranslation, rotation and scale-invariant image registration [1].\r\n\r\n:Author: `Christoph Gohlke <https://www.cgohlke.com>`_\r\n:License: BSD 3-Clause\r\n:Version: 2024.5.24\r\n\r\nQuickstart\r\n----------\r\n\r\nInstall the imreg package and all dependencies from the\r\n`Python Package Index <https://pypi.org/project/imreg/>`_::\r\n\r\n python -m pip install -U imreg\r\n\r\nSee `Examples`_ for using the programming interface.\r\n\r\nSource code and support are available on\r\n`GitHub <https://github.com/cgohlke/imreg>`_.\r\n\r\nRequirements\r\n------------\r\n\r\nThis revision was tested with the following requirements and dependencies\r\n(other versions may work):\r\n\r\n- `CPython <https://www.python.org>`_ 3.9.13, 3.10.11, 3.11.9, 3.12.3\r\n- `NumPy <https://pypi.org/project/numpy/>`_ 1.26.4\r\n- `Scipy <https://pypi.org/project/scipy>`_ 1.12.0\r\n- `Matplotlib 3.8.4 <https://pypi.org/project/matplotlib>`_\r\n (optional for plotting)\r\n\r\nRevisions\r\n---------\r\n\r\n2024.5.24\r\n\r\n- Support NumPy 2.\r\n- Fix docstring examples not correctly rendered on GitHub.\r\n\r\n2024.1.2\r\n\r\n- Add type hints.\r\n- Drop support for Python 3.8 and numpy < 1.23 (NEP29).\r\n\r\n2022.9.27\r\n\r\n- Fix scipy.ndimage DeprecationWarning.\r\n\r\nNotes\r\n-----\r\n\r\nImreg is no longer being actively developed.\r\n\r\nThis implementation is mainly for educational purposes.\r\n\r\nAn improved version is being developed at https://github.com/matejak/imreg_dft.\r\n\r\nReferences\r\n----------\r\n\r\n1. An FFT-based technique for translation, rotation and scale-invariant\r\n image registration. BS Reddy, BN Chatterji.\r\n IEEE Transactions on Image Processing, 5, 1266-1271, 1996\r\n2. An IDL/ENVI implementation of the FFT-based algorithm for automatic\r\n image registration. H Xiea, N Hicksa, GR Kellera, H Huangb, V Kreinovich.\r\n Computers & Geosciences, 29, 1045-1055, 2003.\r\n3. Image Registration Using Adaptive Polar Transform. R Matungka, YF Zheng,\r\n RL Ewing. IEEE Transactions on Image Processing, 18(10), 2009.\r\n\r\nExamples\r\n--------\r\n\r\n>>> im0 = imread('t400')\r\n>>> im1 = imread('Tr19s1.3')\r\n>>> im2, scale, angle, (t0, t1) = similarity(im0, im1)\r\n>>> imshow(im0, im1, im2)\r\n\r\n>>> im0 = imread('t350380ori')\r\n>>> im1 = imread('t350380shf')\r\n>>> t0, t1 = translation(im0, im1)\r\n>>> t0, t1\r\n(20, 50)\r\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "FFT based image registration",
"version": "2024.5.24",
"project_urls": {
"Bug Tracker": "https://github.com/cgohlke/imreg/issues",
"Homepage": "https://www.cgohlke.com",
"Source Code": "https://github.com/cgohlke/imreg"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d95646717ee1de683c32bd267da71cc5661f475944503d2dd250e99b466f0de2",
"md5": "44a8dd8a1707c568f2e50b3428655af5",
"sha256": "d9ec4b84949eb54ef13f8872b654c9eb67e1b7e2e5159c08ccb0b785da663a98"
},
"downloads": -1,
"filename": "imreg-2024.5.24-py3-none-any.whl",
"has_sig": false,
"md5_digest": "44a8dd8a1707c568f2e50b3428655af5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 7888,
"upload_time": "2024-05-25T17:10:01",
"upload_time_iso_8601": "2024-05-25T17:10:01.464056Z",
"url": "https://files.pythonhosted.org/packages/d9/56/46717ee1de683c32bd267da71cc5661f475944503d2dd250e99b466f0de2/imreg-2024.5.24-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e08fca9b98344705ddcb0fa88506e06887774434c44a69b2bc0097c3a56998a4",
"md5": "076cd6bcdb857837a691793b5e8484f1",
"sha256": "a12cdbe85dcf36841dad24fa2f6c5b19a8f835a69fc29bb1a6d360f01404a95c"
},
"downloads": -1,
"filename": "imreg-2024.5.24.tar.gz",
"has_sig": false,
"md5_digest": "076cd6bcdb857837a691793b5e8484f1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 7153,
"upload_time": "2024-05-25T17:10:03",
"upload_time_iso_8601": "2024-05-25T17:10:03.255074Z",
"url": "https://files.pythonhosted.org/packages/e0/8f/ca9b98344705ddcb0fa88506e06887774434c44a69b2bc0097c3a56998a4/imreg-2024.5.24.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-25 17:10:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cgohlke",
"github_project": "imreg",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "imreg"
}