========================================================================
OrientationPy - greylevel orientation computation for 2D and 3D images
========================================================================
.. image:: https://badge.fury.io/py/orientationpy.png
:target: http://badge.fury.io/py/orientationpy
.. image:: https://gitlab.com/epfl-center-for-imaging/orientationpy/badges/main/pipeline.svg
:target: https://gitlab.com/epfl-center-for-imaging/orientationpy/-/commits/main
.. image:: https://gitlab.com/epfl-center-for-imaging/orientationpy/badges/main/coverage.svg
:target: https://epfl-center-for-imaging.gitlab.io/orientationpy/coverage/
OrientationPy is the pythonic successor to the well-loved `OrientationJ`_ Fiji Plugin (`github`_) from the BIG (`Biomedical Imaging Group`_) in EPFL.
It is a library that takes in 2D images or 3D volumes and computes the orientation of the greylevels.
A key step is the computation of image gradients, for which we offer a number of different techniques.
Please visit the `OrientationPy online docs`_.
Highlights
===========
Please see the `Example Gallery`_ for some small examples of the use of the code, allowing the computation of orientations maps like this:
.. figure:: https://epfl-center-for-imaging.gitlab.io/orientationpy/_images/sphx_glr_plot_fibres_2d_005.png
:width: 400
:align: center
Other noteworthy python projects
=================================
Other orientation or structure tensor software that we're aware of in python:
- `skimage.feature.structure_tensor`_: Sobel filter for gradient
- `structure-tensor`_: Only using finite differences for gradient
- `pynamix.measure.orientation_map`_: FFT-based approach
- `PyTextureAnalysis`_: 2D orientation package with overlay rendering
Acknowledgements
=================
- The initial prototype was coded by Alexandru Vasile during a 6-week visit to the EPFL Center for Imaging, supported by Mariana Verezhak from PSI
- We used some of this data for testing: https://zenodo.org/record/5483719#.Yyra4vFBy2A
- We initialised this repository from a cookie-cutter: https://github.com/Nekroze/cookiecutter-pypackage
.. _OrientationJ: http://bigwww.epfl.ch/demo/orientation/
.. _github: https://github.com/Biomedical-Imaging-Group/OrientationJ
.. _Biomedical Imaging Group: https://github.com/Biomedical-Imaging-Group/OrientationJ
.. _OrientationPy online docs: https://epfl-center-for-imaging.gitlab.io/orientationpy/index.html
.. _Example Gallery: https://epfl-center-for-imaging.gitlab.io/orientationpy/orientationpy_examples/index.html
.. _skimage.feature.structure_tensor: https://scikit-image.org/docs/stable/api/skimage.feature.html#skimage.feature.structure_tensor
.. _structure-tensor: https://pypi.org/project/structure-tensor/
.. _pynamix.measure.orientation_map: https://scigem.github.io/PynamiX/build/html/notebooks/Fibres.html
.. _PyTextureAnalysis: https://github.com/ajinkya-kulkarni/PyTextureAnalysis
History
========
- 0.3.0.0 (2023-08-07) Closed form solution for eigenvalue decomposition
- 0.2.0.4 (2023-01-20) Anisotropy of voxel sizes implemented
- 0.2.0.3 (2023-01-13) Moved code to `/src/orientationpy` so it gets packaged?
- 0.2.0.2 (2023-01-13) Moved code to `/src` so it gets packaged?
- 0.2.0.1 (2023-01-13) Moved to `pyproject.toml`
- 0.2.0.0 (2023-01-13) First version on pip (non-working due to requirements.txt)
Raw data
{
"_id": null,
"home_page": null,
"name": "orientationpy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "Edward And\u00f2 <edward.ando@epfl.ch>",
"keywords": "orientation, structure tensor, greylevel, image analysis",
"author": null,
"author_email": "Edward And\u00f2 <edward.ando@epfl.ch>, Alexandru Vasile <vasilealexandrupetru@gmail.com>, Daniel Sage <daniel.sage@epfl.ch>, Florian Aymanns <florian.aymanns@epfl.ch>, Mallory Wittwer <mallory.wittwer@epfl.ch>, Joan Ru\u00e9 Queralt <joan.ruequeralt@epfl.ch>",
"download_url": "https://files.pythonhosted.org/packages/d1/70/5b272837a6c9c338a98c23ed8c38a18e3aec506a26a279ba70c65e7bbebe/orientationpy-0.3.0.tar.gz",
"platform": null,
"description": "========================================================================\nOrientationPy - greylevel orientation computation for 2D and 3D images\n========================================================================\n\n.. image:: https://badge.fury.io/py/orientationpy.png\n :target: http://badge.fury.io/py/orientationpy\n\n.. image:: https://gitlab.com/epfl-center-for-imaging/orientationpy/badges/main/pipeline.svg\n :target: https://gitlab.com/epfl-center-for-imaging/orientationpy/-/commits/main\n\n.. image:: https://gitlab.com/epfl-center-for-imaging/orientationpy/badges/main/coverage.svg\n :target: https://epfl-center-for-imaging.gitlab.io/orientationpy/coverage/\n\nOrientationPy is the pythonic successor to the well-loved `OrientationJ`_ Fiji Plugin (`github`_) from the BIG (`Biomedical Imaging Group`_) in EPFL.\nIt is a library that takes in 2D images or 3D volumes and computes the orientation of the greylevels.\nA key step is the computation of image gradients, for which we offer a number of different techniques.\n\nPlease visit the `OrientationPy online docs`_.\n\n\nHighlights\n===========\n\nPlease see the `Example Gallery`_ for some small examples of the use of the code, allowing the computation of orientations maps like this:\n\n\n.. figure:: https://epfl-center-for-imaging.gitlab.io/orientationpy/_images/sphx_glr_plot_fibres_2d_005.png\n :width: 400\n :align: center\n\n\n\nOther noteworthy python projects\n=================================\n\nOther orientation or structure tensor software that we're aware of in python:\n\n - `skimage.feature.structure_tensor`_: Sobel filter for gradient\n - `structure-tensor`_: Only using finite differences for gradient\n - `pynamix.measure.orientation_map`_: FFT-based approach\n - `PyTextureAnalysis`_: 2D orientation package with overlay rendering\n\n\nAcknowledgements\n=================\n\n - The initial prototype was coded by Alexandru Vasile during a 6-week visit to the EPFL Center for Imaging, supported by Mariana Verezhak from PSI\n\n - We used some of this data for testing: https://zenodo.org/record/5483719#.Yyra4vFBy2A\n\n - We initialised this repository from a cookie-cutter: https://github.com/Nekroze/cookiecutter-pypackage\n\n.. _OrientationJ: http://bigwww.epfl.ch/demo/orientation/\n.. _github: https://github.com/Biomedical-Imaging-Group/OrientationJ\n.. _Biomedical Imaging Group: https://github.com/Biomedical-Imaging-Group/OrientationJ\n\n.. _OrientationPy online docs: https://epfl-center-for-imaging.gitlab.io/orientationpy/index.html\n.. _Example Gallery: https://epfl-center-for-imaging.gitlab.io/orientationpy/orientationpy_examples/index.html\n\n\n.. _skimage.feature.structure_tensor: https://scikit-image.org/docs/stable/api/skimage.feature.html#skimage.feature.structure_tensor\n.. _structure-tensor: https://pypi.org/project/structure-tensor/\n.. _pynamix.measure.orientation_map: https://scigem.github.io/PynamiX/build/html/notebooks/Fibres.html\n.. _PyTextureAnalysis: https://github.com/ajinkya-kulkarni/PyTextureAnalysis\n\n\nHistory\n========\n\n - 0.3.0.0 (2023-08-07) Closed form solution for eigenvalue decomposition\n\n - 0.2.0.4 (2023-01-20) Anisotropy of voxel sizes implemented\n\n - 0.2.0.3 (2023-01-13) Moved code to `/src/orientationpy` so it gets packaged?\n\n - 0.2.0.2 (2023-01-13) Moved code to `/src` so it gets packaged?\n\n - 0.2.0.1 (2023-01-13) Moved to `pyproject.toml`\n\n - 0.2.0.0 (2023-01-13) First version on pip (non-working due to requirements.txt)\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Package for greyscale orientation analysis on 2D and 3D images",
"version": "0.3.0",
"project_urls": {
"documentation": "https://readthedocs.org",
"homepage": "https://epfl-center-for-imaging.gitlab.io/orientationpy/index.html",
"repository": "https://gitlab.com/epfl-center-for-imaging/orientationpy"
},
"split_keywords": [
"orientation",
" structure tensor",
" greylevel",
" image analysis"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "04dd10a5f1b787d06e0c4b1a8d98c384da43e573bbf76761ba981647ce964d70",
"md5": "7ff83199471f0dacf76e9ce7d99ca280",
"sha256": "514bca460df91ac0f6b881aac34e785feceda1268dad962449ec7f45c879b08f"
},
"downloads": -1,
"filename": "orientationpy-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7ff83199471f0dacf76e9ce7d99ca280",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 39831,
"upload_time": "2025-02-05T12:40:46",
"upload_time_iso_8601": "2025-02-05T12:40:46.052184Z",
"url": "https://files.pythonhosted.org/packages/04/dd/10a5f1b787d06e0c4b1a8d98c384da43e573bbf76761ba981647ce964d70/orientationpy-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d1705b272837a6c9c338a98c23ed8c38a18e3aec506a26a279ba70c65e7bbebe",
"md5": "47a36f6c7d3c90e2e34f7dac41bb0f8b",
"sha256": "ab22a4bc174e72a9ea803b4dbf790758803a87588c64c07619a199368428272c"
},
"downloads": -1,
"filename": "orientationpy-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "47a36f6c7d3c90e2e34f7dac41bb0f8b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 43083,
"upload_time": "2025-02-05T12:40:47",
"upload_time_iso_8601": "2025-02-05T12:40:47.576669Z",
"url": "https://files.pythonhosted.org/packages/d1/70/5b272837a6c9c338a98c23ed8c38a18e3aec506a26a279ba70c65e7bbebe/orientationpy-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-05 12:40:47",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "epfl-center-for-imaging",
"gitlab_project": "orientationpy",
"lcname": "orientationpy"
}