| Name | imreg JSON |
| Version |
2025.1.1
JSON |
| download |
| home_page | https://www.cgohlke.com |
| Summary | FFT based image registration |
| upload_time | 2025-01-02 02:31:50 |
| maintainer | None |
| docs_url | None |
| author | Christoph Gohlke |
| requires_python | >=3.10 |
| license | BSD |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
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: 2025.1.1
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.10.11, 3.11.9, 3.12.8, 3.13.1 64-bit
- `NumPy <https://pypi.org/project/numpy/>`_ 2.1.3
- `Scipy <https://pypi.org/project/scipy>`_ 1.14.1
- `Matplotlib 3.10.0 <https://pypi.org/project/matplotlib>`_
(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
--------
>>> 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.10",
"maintainer_email": null,
"keywords": null,
"author": "Christoph Gohlke",
"author_email": "cgohlke@cgohlke.com",
"download_url": "https://files.pythonhosted.org/packages/54/77/e05c1f914761b04b2835420adbcd8ae253b5cab096d6ee73a3f4085d17ef/imreg-2025.1.1.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: 2025.1.1\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.10.11, 3.11.9, 3.12.8, 3.13.1 64-bit\r\n- `NumPy <https://pypi.org/project/numpy/>`_ 2.1.3\r\n- `Scipy <https://pypi.org/project/scipy>`_ 1.14.1\r\n- `Matplotlib 3.10.0 <https://pypi.org/project/matplotlib>`_\r\n (optional for plotting)\r\n\r\nRevisions\r\n---------\r\n\r\n2025.1.1\r\n\r\n- Drop support for Python 3.9, support Python 3.13.\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": "2025.1.1",
"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": "3fe99faa70da663c29e90dd78f5f1aa1f2632ac50db9a5ef16668e1f010f0295",
"md5": "bccfab5136b456cc66878decd1454956",
"sha256": "c186631864d9819dfdef28c5cbff240e37968c2a4edf7a3117363627dd8481a6"
},
"downloads": -1,
"filename": "imreg-2025.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bccfab5136b456cc66878decd1454956",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 8079,
"upload_time": "2025-01-02T02:31:37",
"upload_time_iso_8601": "2025-01-02T02:31:37.639998Z",
"url": "https://files.pythonhosted.org/packages/3f/e9/9faa70da663c29e90dd78f5f1aa1f2632ac50db9a5ef16668e1f010f0295/imreg-2025.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5477e05c1f914761b04b2835420adbcd8ae253b5cab096d6ee73a3f4085d17ef",
"md5": "b85ed14bd96ad49ff17e1a736037db16",
"sha256": "3f62e08f9b220e7944d914f829f2d0bae6e09a4406d7af842e5ea08b50f008ec"
},
"downloads": -1,
"filename": "imreg-2025.1.1.tar.gz",
"has_sig": false,
"md5_digest": "b85ed14bd96ad49ff17e1a736037db16",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 7212,
"upload_time": "2025-01-02T02:31:50",
"upload_time_iso_8601": "2025-01-02T02:31:50.008385Z",
"url": "https://files.pythonhosted.org/packages/54/77/e05c1f914761b04b2835420adbcd8ae253b5cab096d6ee73a3f4085d17ef/imreg-2025.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-02 02:31:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cgohlke",
"github_project": "imreg",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "imreg"
}
