Skip to content

Latest commit

 

History

History
47 lines (32 loc) · 2.15 KB

README.md

File metadata and controls

47 lines (32 loc) · 2.15 KB
Raw

IPython Sankey diagram widget Binder

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

Installation

Prerequesites: You need to have installed and enabled ipywidgets. If installing with pip, make sure to have enabled it by running jupyter nbextension enable --py --sys-prefix widgetsnbextension. Installing using conda does this automatically.

To install use pip:

$ pip install ipysankeywidget
$ jupyter nbextension enable --py --sys-prefix ipysankeywidget

For a development installation (requires npm),

$ git clone https://github.com/ricklupton/ipysankeywidget.git
$ cd ipysankeywidget
$ pip install -e .
$ jupyter nbextension install --py --symlink --user ipysankeywidget
$ jupyter nbextension enable --py --user ipysankeywidget

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 value of the SankeyWidget is exactly the same as the sankey object described there.

Examples

See notebooks in examples folder for usage examples. You can try these online using Binder, or follow the links to static versions on nbviewer: