# napari-shape-odyssey
[](https://github.com/jo-mueller/napari-shape-odyssey/raw/main/LICENSE)
[](https://pypi.org/project/napari-shape-odyssey)
[](https://python.org)
[](https://github.com/jo-mueller/napari-shape-odyssey/actions)
[](https://codecov.io/gh/jo-mueller/napari-shape-odyssey)
[](https://napari-hub.org/plugins/napari-shape-odyssey)
Analyze shapes of meshes: This plugin provides advanced measures of shape for meshes. It is based largely on the following libraries and tools:
* [PyFM](https:/github.com/robinmagnet/pyfm)
* [boundary-first-flattening](https://github.com/GeometryCollective/boundary-first-flattening)
## Shape analysis
This plugin provides Laplace spectra ([Reuter, Wolter, Peinecke (2005)](https://dl.acm.org/doi/abs/10.1145/1060244.1060256)), heat kernel signatures ([Bronstein & Kokkinos (2010)](https://ieeexplore.ieee.org/abstract/document/5539838/)) & wave kernel signatures ([Audrey, Schlickewei, Cremers et al.](https://ieeexplore.ieee.org/abstract/document/6130444)).
**Laplace spectra** can be imagined to be the equivalent of resonance modes on the surface of a mesh. The resonance and the resonance modes can, for typical objects, look like this:
**Heat kernel signatures**: Heat dissipation on a mesh depends on local geometry. You can use the heat kernel signature to easily generate a large number of local features of shape
## Unwrapping
This plugin provides a number of methods to unwrap a mesh into basic shapes such as spheres or disks. The method relies on [boundary-first flattening](https://github.com/GeometryCollective/boundary-first-flattening) - currently it's only available on Windows.
----------------------------------
This [napari] plugin was generated with [Cookiecutter] using [@napari]'s [cookiecutter-napari-plugin] template.
<!--
Don't miss the full getting started guide to set up your new package:
https://github.com/napari/cookiecutter-napari-plugin#getting-started
and review the napari docs for plugin developers:
https://napari.org/stable/plugins/index.html
-->
## Installation
You can install `napari-shape-odyssey` via [pip]:
´´´bash
pip install napari-shape-odyssey
napari-skimage-regionprops @ git+https://github.com/jo-mueller/napari-skimage-regionprops.git
pyFM @ git+https://github.com/RobinMagnet/pyFM.git
´´´
## Contributing
Contributions are very welcome. Tests can be run with [tox], please ensure
the coverage at least stays the same before you submit a pull request.
## License
Distributed under the terms of the [BSD-3] license,
"napari-shape-odyssey" is free and open source software
## Issues
If you encounter any problems, please [file an issue] along with a detailed description.
[napari]: https://github.com/napari/napari
[Cookiecutter]: https://github.com/audreyr/cookiecutter
[@napari]: https://github.com/napari
[MIT]: http://opensource.org/licenses/MIT
[BSD-3]: http://opensource.org/licenses/BSD-3-Clause
[GNU GPL v3.0]: http://www.gnu.org/licenses/gpl-3.0.txt
[GNU LGPL v3.0]: http://www.gnu.org/licenses/lgpl-3.0.txt
[Apache Software License 2.0]: http://www.apache.org/licenses/LICENSE-2.0
[Mozilla Public License 2.0]: https://www.mozilla.org/media/MPL/2.0/index.txt
[cookiecutter-napari-plugin]: https://github.com/napari/cookiecutter-napari-plugin
[napari]: https://github.com/napari/napari
[tox]: https://tox.readthedocs.io/en/latest/
[pip]: https://pypi.org/project/pip/
[PyPI]: https://pypi.org/
Raw data
{
"_id": null,
"home_page": "",
"name": "napari-shape-odyssey",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "Johannes Soltwedel",
"author_email": "johannes_richard.soltwedel@tu-dresden.de",
"download_url": "https://files.pythonhosted.org/packages/e5/9a/f8e83b5f087ef1659c725a4450657db56262fadd7a85a5f287dd9bf7d403/napari-shape-odyssey-0.1.1.tar.gz",
"platform": null,
"description": "# napari-shape-odyssey\n\n[](https://github.com/jo-mueller/napari-shape-odyssey/raw/main/LICENSE)\n[](https://pypi.org/project/napari-shape-odyssey)\n[](https://python.org)\n[](https://github.com/jo-mueller/napari-shape-odyssey/actions)\n[](https://codecov.io/gh/jo-mueller/napari-shape-odyssey)\n[](https://napari-hub.org/plugins/napari-shape-odyssey)\n\nAnalyze shapes of meshes: This plugin provides advanced measures of shape for meshes. It is based largely on the following libraries and tools:\n\n* [PyFM](https:/github.com/robinmagnet/pyfm)\n* [boundary-first-flattening](https://github.com/GeometryCollective/boundary-first-flattening)\n\n## Shape analysis\n\nThis plugin provides Laplace spectra ([Reuter, Wolter, Peinecke (2005)](https://dl.acm.org/doi/abs/10.1145/1060244.1060256)), heat kernel signatures ([Bronstein & Kokkinos (2010)](https://ieeexplore.ieee.org/abstract/document/5539838/)) & wave kernel signatures ([Audrey, Schlickewei, Cremers et al.](https://ieeexplore.ieee.org/abstract/document/6130444)).\n\n**Laplace spectra** can be imagined to be the equivalent of resonance modes on the surface of a mesh. The resonance and the resonance modes can, for typical objects, look like this:\n\n\n\n**Heat kernel signatures**: Heat dissipation on a mesh depends on local geometry. You can use the heat kernel signature to easily generate a large number of local features of shape\n\n\n\n## Unwrapping\n\nThis plugin provides a number of methods to unwrap a mesh into basic shapes such as spheres or disks. The method relies on [boundary-first flattening](https://github.com/GeometryCollective/boundary-first-flattening) - currently it's only available on Windows.\n\n\n\n\n\n----------------------------------\n\nThis [napari] plugin was generated with [Cookiecutter] using [@napari]'s [cookiecutter-napari-plugin] template.\n\n<!--\nDon't miss the full getting started guide to set up your new package:\nhttps://github.com/napari/cookiecutter-napari-plugin#getting-started\n\nand review the napari docs for plugin developers:\nhttps://napari.org/stable/plugins/index.html\n-->\n\n## Installation\n\nYou can install `napari-shape-odyssey` via [pip]:\n\n\u00b4\u00b4\u00b4bash\n pip install napari-shape-odyssey\n napari-skimage-regionprops @ git+https://github.com/jo-mueller/napari-skimage-regionprops.git\n pyFM @ git+https://github.com/RobinMagnet/pyFM.git\n\u00b4\u00b4\u00b4\n\n\n\n\n## Contributing\n\nContributions are very welcome. Tests can be run with [tox], please ensure\nthe coverage at least stays the same before you submit a pull request.\n\n## License\n\nDistributed under the terms of the [BSD-3] license,\n\"napari-shape-odyssey\" is free and open source software\n\n## Issues\n\nIf you encounter any problems, please [file an issue] along with a detailed description.\n\n[napari]: https://github.com/napari/napari\n[Cookiecutter]: https://github.com/audreyr/cookiecutter\n[@napari]: https://github.com/napari\n[MIT]: http://opensource.org/licenses/MIT\n[BSD-3]: http://opensource.org/licenses/BSD-3-Clause\n[GNU GPL v3.0]: http://www.gnu.org/licenses/gpl-3.0.txt\n[GNU LGPL v3.0]: http://www.gnu.org/licenses/lgpl-3.0.txt\n[Apache Software License 2.0]: http://www.apache.org/licenses/LICENSE-2.0\n[Mozilla Public License 2.0]: https://www.mozilla.org/media/MPL/2.0/index.txt\n[cookiecutter-napari-plugin]: https://github.com/napari/cookiecutter-napari-plugin\n\n[napari]: https://github.com/napari/napari\n[tox]: https://tox.readthedocs.io/en/latest/\n[pip]: https://pypi.org/project/pip/\n[PyPI]: https://pypi.org/\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Analyze shapes of meshes",
"version": "0.1.1",
"project_urls": {
"Bug Tracker": "https://github.com/jo-mueller/napari-shape-odyssey/issues",
"Documentation": "https://jo-mueller.github.io/napari-shape-odyssey/intro.html",
"Source Code": "https://github.com/jo-mueller/napari-shape-odyssey",
"User Support": "https://github.com/jo-mueller/napari-shape-odyssey/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3d6b922edf7379f6a2e176e69f00d952ece16bb36875db122df4809bde1ab25f",
"md5": "137a0f8429cbf4ccadec475f5c7aa9cf",
"sha256": "ab389661f1300667e5d0119988c38e7c38902f85d4a3a6537006fb42f89e4a24"
},
"downloads": -1,
"filename": "napari_shape_odyssey-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "137a0f8429cbf4ccadec475f5c7aa9cf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 20909,
"upload_time": "2024-01-02T15:07:51",
"upload_time_iso_8601": "2024-01-02T15:07:51.882502Z",
"url": "https://files.pythonhosted.org/packages/3d/6b/922edf7379f6a2e176e69f00d952ece16bb36875db122df4809bde1ab25f/napari_shape_odyssey-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e59af8e83b5f087ef1659c725a4450657db56262fadd7a85a5f287dd9bf7d403",
"md5": "0c304dd6829a6849124d33a0d63178a5",
"sha256": "9fd540ef720c7d9be5b7d781364ec8fd55fef0d3336a17ab7c778b169e8fe637"
},
"downloads": -1,
"filename": "napari-shape-odyssey-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "0c304dd6829a6849124d33a0d63178a5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 18126,
"upload_time": "2024-01-02T15:07:54",
"upload_time_iso_8601": "2024-01-02T15:07:54.798071Z",
"url": "https://files.pythonhosted.org/packages/e5/9a/f8e83b5f087ef1659c725a4450657db56262fadd7a85a5f287dd9bf7d403/napari-shape-odyssey-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-02 15:07:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jo-mueller",
"github_project": "napari-shape-odyssey",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "napari-shape-odyssey"
}
JSON
