shape odyssey


Analyze shapes of meshes

License BSD-3 PyPI Python Version tests codecov napari hub

Analyze shapes of meshes: This plugin provides advanced measures of shape for meshes. It is based largely on the following libraries and tools:

Shape analysis

This plugin provides Laplace spectra (Reuter, Wolter, Peinecke (2005)), heat kernel signatures (Bronstein & Kokkinos (2010)) & wave kernel signatures (Audrey, Schlickewei, Cremers et al.).

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


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 - currently it's only available on Windows.

This napari plugin was generated with Cookiecutter using @napari's cookiecutter-napari-plugin template.


You can install napari-shape-odyssey via pip:

´´´bash pip install napari-shape-odyssey napari-skimage-regionprops @ git+ pyFM @ git+ ´´´


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.


Distributed under the terms of the BSD-3 license, "napari-shape-odyssey" is free and open source software


If you encounter any problems, please [file an issue] along with a detailed description.


  • 0.1.1

Last updated:

  • 02 January 2024

First released:

  • 31 August 2023


Supported data:

  • Information not submitted

Save extension:

Save layers:

GitHub activity:

  • Stars: 6
  • Forks: 0
  • Issues + PRs: 0

Python versions supported:

Operating system:


  • numpy
  • vedo
  • pandas
  • napari
  • napari-stress
  • napari-process-points-and-surfaces
  • pyfmaps