Create graphs

License PyPI Python Version tests codecov

napari hub

Use 🍒 Griottes 🍒 in napari!


Install from napari


You can install napari-griottes via pip:

pip install napari-griottes

To install latest development version :

pip install git+


Starting with labels:

  1. Open the plugin in Plugins/napari-griottes
  2. Make sure the layer with labels is selected
  3. Click Run once to get centers
  4. Click Run second time to get graph
  5. Select the right kind of graph in the drop-down menu
  6. Adjust the distance
  7. Adjust thickness

Screenshot from three labels geometric contact mp4

Starting with Segmented cells

  1. Open sample data: File / Open Sample / napari-griottes / Zebrafish 2D with labels
  2. Select the top layer and covert it to labels (right click - Convert to labels)
  3. Run the plugin once to get the centers of labels
  4. Run the plugin twice to get the connections
  5. Proceed with graph creation

Screenshot from cells graphs mp4

Saving and recovering the graph

Any graph you see in napari can be saved in .json format.

  1. Select he layers with connections
  2. Click File/Save Selected Layer
  3. Choose Griottes in drop-down menu
  4. Save

In order to recover a previously saved graph in napari, you can simply drag-n-drop your file into napari, or use file open fialog.


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-griottes" is free and open source software


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


  • 0.4.1

Last updated:

  • 14 April 2023

First released:

  • 09 March 2023


Supported data:

  • Information not submitted

Save extension:

Save layers:

GitHub activity:

  • Stars: 3
  • Forks: 1
  • Issues + PRs: 1

Python versions supported:

Operating system:


  • griottes
  • networkx
  • numpy
  • pandas (<2)