ipysankeywidget

Display Sankey diagrams in IPython / Jupyter notebook using d3-sankey-diagram.

Installation

pip install ipysankeywidget

or with uv:

uv add ipysankeywidget

or with conda:

conda install -c conda-forge ipysankeywidget

For a development install, see DEVELOPING.md.

Browser support

Tested in Firefox and Chrome. There have been reports that it's not working in Safari.

Documentation

See the d3-sankey-diagram API docs: the attributes of the SankeyWidget are the same as the properties of the sankey object described there.

To change the figure size, use the ipywidgets Layout object:

layout = Layout(width="1000", height="1200")
SankeyWidget(links=data, layout=layout)

Examples

See notebooks in examples folder for usage examples.

uv run jupyter lab examples/Simple\ example.ipynb

You can also try these online using Binder, or follow the links to static versions on nbviewer:

• Simple example
• Advanced examples
• Linking and Layout
• Exporting Images

Changelog

Unreleased

v0.6.0 (26 March 2025)

• Updated to use anywidget for simpler packaging.
• Updated d3-sankey-diagram to v0.9.1

v0.5.0 (16 December 2022)

• Compatible with Jupyter Lab as well as Jupyter notebook.

v0.4.2 (29 April 2022)

• Expose d3-sankey-diagram nodePositions() option to allow for custom node layout.

v0.4.1 (18 February 2021)

• Experimental support for link "markers"
• Experimental support for showing HTML info for links

v0.4.0 (19 November 2020)

• Update to d3-sankey-diagram v0.8.0

v0.3.0

• Now supports Jupyterlab

v0.2.5

• You can now show link values as SVG text elements. Set linkLabelFormat to a d3-format string; links whose value is more than linkLabelMinWidth will have a label using that format.
• Upgrade to d3-sankey-diagram version 0.7.3
• ipysankeywidget can now be installed using conda (thanks to Ali Alsabbah #33)
• Add a check for duplicate links (thanks to Remi Bois #23)

v0.2.4

• Add events for clicking on nodes and links: on_node_clicked and on_link_clicked. These replace the on_selected event.

Contributors

• Rick Lupton
• Nicholas Bollweg
• Ali Alsabbah
• Remi Bois
• Miguel Mendez