General overview
================
``imreg_dft`` is your first-choice Python image registration utility.
In plain language, it implements means of guessing translation, rotation and scale variation between two images.
The name comes from the fact that it doesn't work with those images directly, but it works with their spectrum (DFT using FFT), and its log-polar transformation [1]_, hence the ``_dft`` after ``imreg``.
Basically, if you want to align two images that have different scale and are rotated and shifted against each other, ``imreg_dft`` is the tool you want to check out.
`Get started <http://pythonhosted.org/imreg_dft/quickstart.html#quickstart>`_ in five minutes and see how it works for you!
:Authors:
- `Matěj Týč <https://github.com/matejak>`_ `PGP public key <https://keyserver.mattrude.com/pks/lookup?op=get&search=0x607524F854FD905F>`_
- `Christoph Gohlke <http://www.lfd.uci.edu/~gohlke/>`_
:Organization:
- Brno University of Technology, Brno, Czech Republic
- Laboratory for Fluorescence Dynamics, University of California, Irvine
:Copyright:
- 2014-2015, Matěj Týč
- 2011-2014, Christoph Gohlke
.. _requirements:
Requirements
------------
``imreg_dft`` is `free software <http://en.wikipedia.org/wiki/Free_software>`_, i.e. both free of charge (so it is free as free beer) and you as a user are granted `four basic freedoms <https://www.gnu.org/philosophy/free-sw.html>`_ (so it is also free as free speech).
Generally, you will need ``numpy`` and ``scipy`` for the algorithm functionality and ``matplotlib`` for plotting.
For the command-line tool, reading images is useful, so make sure you have ``pillow`` (or ``PIL``, which is deprecated).
Quickstart
----------
Check the documentation on `readthedocs.ort <http://imreg-dft.readthedocs.org/en/latest/quickstart.html>`_ (bleeding-edge) or `pythonhosted.org <http://pythonhosted.org/imreg_dft/quickstart.html>`_ (with images).
Or even better, generate the documentation yourself!
1. Install the package by running ``python setup.py install`` in the project root.
#. Install packages that are required for the documentation to compile (see the ``requirements_docs.txt`` file.
#. Go to the ``doc`` directory and run ``make html`` there.
The documentation should appear in the ``_build`` subfolder, so you may open ``_build/html/index.html`` with your web browser to see it.
Notes
-----
``imreg_dft`` is based on the `code <http://www.lfd.uci.edu/~gohlke/code/imreg.py.html>`_ by Christoph Gohlke.
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
Raw data
{
"_id": null,
"home_page": "https://github.com/matejak/imreg_dft",
"name": "imreg_dft",
"maintainer": null,
"docs_url": "https://pythonhosted.org/imreg_dft/",
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Mat\u011bj T\u00fd\u010d",
"author_email": "matej.tyc@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/c3/68/57cf1e086e8cc8f75a647e8815d7cb5f9dc4686031687aad5e8e30980ce4/imreg_dft-2.0.0.tar.gz",
"platform": "UNKNOWN",
"description": "General overview\n================\n\n``imreg_dft`` is your first-choice Python image registration utility.\nIn plain language, it implements means of guessing translation, rotation and scale variation between two images.\nThe name comes from the fact that it doesn't work with those images directly, but it works with their spectrum (DFT using FFT), and its log-polar transformation [1]_, hence the ``_dft`` after ``imreg``.\n\nBasically, if you want to align two images that have different scale and are rotated and shifted against each other, ``imreg_dft`` is the tool you want to check out.\n`Get started <http://pythonhosted.org/imreg_dft/quickstart.html#quickstart>`_ in five minutes and see how it works for you!\n\n:Authors:\n - `Mat\u011bj T\u00fd\u010d <https://github.com/matejak>`_ `PGP public key <https://keyserver.mattrude.com/pks/lookup?op=get&search=0x607524F854FD905F>`_\n - `Christoph Gohlke <http://www.lfd.uci.edu/~gohlke/>`_\n\n:Organization:\n - Brno University of Technology, Brno, Czech Republic\n - Laboratory for Fluorescence Dynamics, University of California, Irvine\n\n:Copyright:\n - 2014-2015, Mat\u011bj T\u00fd\u010d\n - 2011-2014, Christoph Gohlke\n\n.. _requirements:\n \nRequirements\n------------\n\n``imreg_dft`` is `free software <http://en.wikipedia.org/wiki/Free_software>`_, i.e. both free of charge (so it is free as free beer) and you as a user are granted `four basic freedoms <https://www.gnu.org/philosophy/free-sw.html>`_ (so it is also free as free speech).\n\nGenerally, you will need ``numpy`` and ``scipy`` for the algorithm functionality and ``matplotlib`` for plotting.\nFor the command-line tool, reading images is useful, so make sure you have ``pillow`` (or ``PIL``, which is deprecated).\n\nQuickstart\n----------\n\nCheck the documentation on `readthedocs.ort <http://imreg-dft.readthedocs.org/en/latest/quickstart.html>`_ (bleeding-edge) or `pythonhosted.org <http://pythonhosted.org/imreg_dft/quickstart.html>`_ (with images).\nOr even better, generate the documentation yourself! \n\n1. Install the package by running ``python setup.py install`` in the project root.\n#. Install packages that are required for the documentation to compile (see the ``requirements_docs.txt`` file.\n#. Go to the ``doc`` directory and run ``make html`` there.\n The documentation should appear in the ``_build`` subfolder, so you may open ``_build/html/index.html`` with your web browser to see it.\n\nNotes\n-----\n\n``imreg_dft`` is based on the `code <http://www.lfd.uci.edu/~gohlke/code/imreg.py.html>`_ by Christoph Gohlke.\n\nReferences\n----------\n.. [1] An FFT-based technique for translation, rotation and scale-invariant\n image registration. BS Reddy, BN Chatterji.\n IEEE Transactions on Image Processing, 5, 1266-1271, 1996",
"bugtrack_url": null,
"license": "BSD",
"summary": "Image registration utility using algorithms based on discrete Fourier transform (DFT, FFT)",
"version": "2.0.0",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c36857cf1e086e8cc8f75a647e8815d7cb5f9dc4686031687aad5e8e30980ce4",
"md5": "2473b3f99de6159b5b43b2355c05558a",
"sha256": "bd36c17b7a4fd0ddb0821a68c216c9aa449c7fc1d22e7d13f80a129725370645"
},
"downloads": -1,
"filename": "imreg_dft-2.0.0.tar.gz",
"has_sig": true,
"md5_digest": "2473b3f99de6159b5b43b2355c05558a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 101647,
"upload_time": "2016-06-18T22:42:21",
"upload_time_iso_8601": "2016-06-18T22:42:21.703506Z",
"url": "https://files.pythonhosted.org/packages/c3/68/57cf1e086e8cc8f75a647e8815d7cb5f9dc4686031687aad5e8e30980ce4/imreg_dft-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2016-06-18 22:42:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "matejak",
"github_project": "imreg_dft",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "setuptools",
"specs": [
[
">=",
"1.0"
]
]
},
{
"name": "numpy",
"specs": [
[
">=",
"1.7"
]
]
},
{
"name": "scipy",
"specs": [
[
">=",
"0.12"
]
]
},
{
"name": "pillow",
"specs": []
}
],
"lcname": "imreg_dft"
}
JSON
