imreg


Nameimreg JSON
Version 2024.5.24 PyPI version JSON
download
home_pagehttps://www.cgohlke.com
SummaryFFT based image registration
upload_time2024-05-25 17:10:03
maintainerNone
docs_urlNone
authorChristoph Gohlke
requires_python>=3.9
licenseBSD
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: 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"
}
        
Elapsed time: 1.48700s