Welcome to altair-upset’s documentation!#

https://badge.fury.io/py/altair-upset.svg https://img.shields.io/pypi/pyversions/altair-upset.svg https://readthedocs.org/projects/altair-upset/badge/?version=latest https://img.shields.io/badge/License-MIT-yellow.svg

Create beautiful and interactive UpSet plots using Altair. UpSet plots are a powerful alternative to Venn diagrams for visualizing set intersections, especially when dealing with many sets. The library supports both Pandas and Polars DataFrames, making it flexible for different data processing workflows.

Quick Start#

Installation#

pip install altair-upset

Basic Usage#

You can use altair-upset with either Pandas or Polars DataFrames:

import altair_upset as au
import pandas as pd

# Using Pandas
data = pd.DataFrame({
    'set1': [1, 0, 1, 1],
    'set2': [1, 1, 0, 1],
    'set3': [0, 1, 1, 0]
})

# Create an UpSet plot
chart = au.UpSetAltair(
    data=data,
    sets=["set1", "set2", "set3"],
    title="Sample UpSet Plot"
).chart

chart

For Polars usage and more advanced examples, check out the Using Polars with UpSet Plots in our example gallery.

Contents#

Indices and tables#