Skip to main content

Build animated charts in Jupyter Notebook and similar environments with a simple Python syntax.

Project description

Vizzu

ipyvizzu - Build animated charts in Jupyter Notebook and similar environments with a simple Python syntax

Documentation · Examples · Code reference · Repository · Blog

PyPI version Conda Version CI-CD

ipyvizzu

About The Project

ipyvizzu is an animated charting tool for Jupyter, Google Colab, Databricks, Kaggle and Deepnote notebooks among other platforms. ipyvizzu enables data scientists and analysts to utilize animation for storytelling with data using Python. It's built on the open-source JavaScript/C++ charting library Vizzu.

There is a new extension of ipyvizzu, ipyvizzu-story with which the animated charts can be presented right from the notebooks. Since ipyvizzu-story's syntax is a bit different to ipyvizzu's, we suggest you to start from the ipyvizzu-story repo if you're interested in using animated charts to present your findings live or to share your presentation as an HTML file.

Similarly to Vizzu, ipyvizzu utilizes a generic dataviz engine that generates many types of charts and seamlessly animates between them. It is designed for building animated data stories as it enables showing different perspectives of the data that the viewers can easily follow.

Main features:

  • Designed with animation in focus;
  • Defaults based on data visualization guidelines;
  • Works with Pandas dataframe, while also JSON and inline data input is available;
  • Auto scrolling feature to keep the actual chart in position while executing multiple cells.

Installation

pip install ipyvizzu

Visit Installation chapter for more options and details.

Usage

You can create the animation below with the following code snippet.

ipyvizzu

import pandas as pd
from ipyvizzu import Chart, Data, Config

df = pd.read_csv(
    "https://ipyvizzu.vizzuhq.com/0.18/showcases/titanic/titanic.csv"
)
data = Data()
data.add_df(df)

chart = Chart(width="640px", height="360px")

chart.animate(data)

chart.animate(
    Config(
        {
            "x": "Count",
            "y": "Sex",
            "label": "Count",
            "title": "Passengers of the Titanic",
        }
    )
)
chart.animate(
    Config(
        {
            "x": ["Count", "Survived"],
            "label": ["Count", "Survived"],
            "color": "Survived",
        }
    )
)
chart.animate(Config({"x": "Count", "y": ["Sex", "Survived"]}))

Documentation

Visit our Documentation site for more details and a step-by-step tutorial into ipyvizzu or check out our Example gallery.

Environments

ipyvizzu can be used in a wide variety of environments, visit Environments chapter for more details.

Extensions

  • ipyvizzu-story adds presentation controls to present data stories live or to share them as an interactive HTML file.

Contributing

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

Contact

Usage Statistics

ipyvizzu collects aggregate usage statistics by default to follow the progress and overall trends of our library. This feature is optional, and users can choose to opt-out. However, we do not track, collect, or store any personal data or personally identifiable information. Please note that even when this feature is enabled, publishing anything made with ipyvizzu remains GDPR compatible. For more details, please visit Analytics chapter.

License

Copyright © 2022-2025 Vizzu Inc.

Released under the Apache 2.0 License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ipyvizzu-0.18.0.tar.gz (44.5 kB view details)

Uploaded Source

Built Distribution

ipyvizzu-0.18.0-py3-none-any.whl (40.0 kB view details)

Uploaded Python 3

File details

Details for the file ipyvizzu-0.18.0.tar.gz.

File metadata

  • Download URL: ipyvizzu-0.18.0.tar.gz
  • Upload date:
  • Size: 44.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for ipyvizzu-0.18.0.tar.gz
Algorithm Hash digest
SHA256 0783c860b644c04a3cf68fc20a980145a718ddce1a97cf0f5a6c67663f03f1ce
MD5 e89c63cec85e02656ac3615673b09c46
BLAKE2b-256 8c47ad40236ba3c9cc7a4112ff692b0452d0edd901a104267634fa564c6eeb28

See more details on using hashes here.

File details

Details for the file ipyvizzu-0.18.0-py3-none-any.whl.

File metadata

  • Download URL: ipyvizzu-0.18.0-py3-none-any.whl
  • Upload date:
  • Size: 40.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for ipyvizzu-0.18.0-py3-none-any.whl
Algorithm Hash digest
SHA256 33cff7d665309f79f11cf9bbe348a5552616ed1aa47edc03dcbf165ced1e0b2f
MD5 cb67ebfeaee3be7106bfccf6b07ce5e7
BLAKE2b-256 fb77e1196fce02ca51bc161d9ac785dcc51173cc345a082651e58f952fc4f324

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page