AutoVizWidget

0.23.0 · active · verified Sat Apr 11

AutoVizWidget is a Python library that provides interactive, automatic visualization capabilities for pandas DataFrames, primarily within Jupyter notebooks. It is part of the broader Jupyter Incubator Sparkmagic project, though it can be installed and used independently to enhance data exploration by leveraging `ipywidgets` for interactive UI elements. The library is currently at version 0.23.0 and sees releases often aligned with its parent Sparkmagic project, typically every few months.

Warnings

breaking Although `autovizwidget`'s direct `pandas` dependency might allow newer versions, its parent project `sparkmagic` (specifically from version 0.20.5) pinned `pandas<2.0.0` due to incompatibilities. If used within a `sparkmagic` environment, `pandas` versions 2.0.0 and above may cause issues.
Fix: Ensure `pandas` version is less than 2.0.0 if using `autovizwidget` in conjunction with `sparkmagic` versions before 0.23.0. For `autovizwidget` 0.23.0, compatibility with `IPython 8/9` was fixed, but the `pandas` pin from `sparkmagic` might still be relevant depending on your overall environment.
gotcha Older versions of `autovizwidget` (prior to 0.23.0) had known compatibility issues with `IPython` versions 8 and 9, leading to display problems.
Fix: Upgrade to `autovizwidget` version 0.23.0 or newer to ensure proper functionality with `IPython` 8 and 9.
gotcha `AutoVizWidget` is developed as part of the `jupyter-incubator/sparkmagic` project. While it can be used independently, its full capabilities, dependency management, and latest compatibility fixes are often tied to `sparkmagic` updates, which might introduce their own breaking changes (e.g., `ipykernel>=6` support in `sparkmagic` 0.20.0).
Fix: When integrating `autovizwidget` into a `sparkmagic`-driven environment, consult the `sparkmagic` release notes for potential ecosystem-wide dependency or behavior changes. Ensure all related packages (`ipywidgets`, `ipykernel`, `pandas`) are compatible with each other and `sparkmagic`.
deprecated The broader `sparkmagic` project, which `autovizwidget` is a part of, dropped support for Python 3.6 in its 0.20.0 release. While `autovizwidget`'s PyPI metadata may not explicitly state a `requires_python` range, it's strongly recommended to use Python 3.7 or newer for full compatibility within the `sparkmagic` ecosystem.
Fix: Use Python 3.7 or a newer version to maintain compatibility and receive updates.

Install

pip install autovizwidget Install latest version

Imports

AutoVizWidget
```
from autovizwidget.widget import AutoVizWidget
```
The main widget class for visualization.

Quickstart

This quickstart demonstrates how to create a pandas DataFrame and then use AutoVizWidget to automatically generate interactive visualizations for it within a Jupyter environment. The `display` function from `IPython.display` is crucial for rendering the widget.

import pandas as pd
from autovizwidget.widget import AutoVizWidget
from IPython.display import display

# Create a sample DataFrame
df = pd.DataFrame({
    'numerical_col': [1, 2, 3, 4, 5],
    'categorical_col': ['A', 'B', 'C', 'D', 'E'],
    'float_col': [10.1, 11.2, 12.3, 13.4, 14.5]
})

# Instantiate and display the AutoVizWidget
av_widget = AutoVizWidget(df)
display(av_widget)

view raw JSON →