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.1.2
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.7, 3.12.1
- `NumPy <https://pypi.org/project/numpy/>`_ 1.26.2
- `Scipy <https://pypi.org/project/scipy>`_ 1.11.4
- `Matplotlib 3.8.2 <https://pypi.org/project/matplotlib>`_
(optional for plotting)
Revisions
---------
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": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "",
"author": "Christoph Gohlke",
"author_email": "cgohlke@cgohlke.com",
"download_url": "https://files.pythonhosted.org/packages/8d/a4/230a8234e5cf73bfbfa496b5f0f5e5cc6f9c9d346cbc70502112c754c0c0/imreg-2024.1.2.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.1.2\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.7, 3.12.1\r\n- `NumPy <https://pypi.org/project/numpy/>`_ 1.26.2\r\n- `Scipy <https://pypi.org/project/scipy>`_ 1.11.4\r\n- `Matplotlib 3.8.2 <https://pypi.org/project/matplotlib>`_\r\n (optional for plotting)\r\n\r\nRevisions\r\n---------\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.1.2",
"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": "df52b968cc2d81930d83b03ea22f1a1a3c23b2495ad54df9e98906cf72d5d1c0",
"md5": "f014f34a25c2c7b5cafadfeb97e8f937",
"sha256": "82e7fa5ebb78edf40baf8326e8b7ec805b4e084ffe07501b46fb9096306d244c"
},
"downloads": -1,
"filename": "imreg-2024.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f014f34a25c2c7b5cafadfeb97e8f937",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 7797,
"upload_time": "2024-01-02T21:49:16",
"upload_time_iso_8601": "2024-01-02T21:49:16.636935Z",
"url": "https://files.pythonhosted.org/packages/df/52/b968cc2d81930d83b03ea22f1a1a3c23b2495ad54df9e98906cf72d5d1c0/imreg-2024.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8da4230a8234e5cf73bfbfa496b5f0f5e5cc6f9c9d346cbc70502112c754c0c0",
"md5": "bb6579fd8eee1361e953908def1b76f7",
"sha256": "c61271d191ae067a6336e6b2e8f08fa7819c5a9506e6bf5cdfd7f2afd808491a"
},
"downloads": -1,
"filename": "imreg-2024.1.2.tar.gz",
"has_sig": false,
"md5_digest": "bb6579fd8eee1361e953908def1b76f7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 6754,
"upload_time": "2024-01-02T21:49:18",
"upload_time_iso_8601": "2024-01-02T21:49:18.226991Z",
"url": "https://files.pythonhosted.org/packages/8d/a4/230a8234e5cf73bfbfa496b5f0f5e5cc6f9c9d346cbc70502112c754c0c0/imreg-2024.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-02 21:49:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cgohlke",
"github_project": "imreg",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "imreg"
}