ipyvizzu - Jupyter notebook integration for Vizzu.

About The Project

ipyvizzu provides Jupyter Notebook integration for Vizzu.

Installation

ipyvizzu requires only IPython package. However you can use it only in Jupyter Notebook therefore notebook project has to be installed.

pip install ipyvizzu
pip install notebook

ipyvizzu downloads Vizzu from jsDelivr CDN by default, but a local copy of it can be used.

Install a local copy of Vizzu.

npm install vizzu@~0.4.0

Change Vizzu's url in the constructor of the Chart class.

from ipyvizzu import Chart

chart = Chart(vizzu="./node_modules/vizzu/dist/vizzu.min.js")

Usage

ipyvizzu only works in Jupiter Notebook environment. A notebook cell may contain the following code snippet.

from ipyvizzu import Chart, Data, Config

data = Data()
data.add_series("Foo", ['Alice', 'Bob', 'Ted'])
data.add_series("Bar", [15, 32, 12])
data.add_series("Baz", [5, 2, 2])

chart = Chart()
chart.animate(data)

chart.animate(Config({"x": "Foo", "y": "Bar", "color": "Foo"}))
chart.animate(Config({"geometry": "circle"}))
chart.animate(Config({"x": "Foo", "y": "Baz", "color": "Foo"}))
chart.animate(Config({"geometry": "rectangle"}))

Visit our documentation site for more tutorials and examples.

Contributing

We welcome contributions to the project, visit our contributing guide for further info.

Contact

Join our Slack: vizzu-community.slack.com
Drop us a line at hello@vizzuhq.com
Follow us on twitter: https://twitter.com/VizzuHQ

License