Waffle chart

⏱ Quick start

The PyWaffle library allows to build a waffle chart easily thanks to its Waffle class.

The input data is a dictionary with names as keys and associated integer values.

The number of rows and columns can be set with the rows and columns arguments:

Most basic waffle chart with Python and the pyWaffle library.

# useful libraries, including pyWaffle
import matplotlib.pyplot as plt
from pywaffle import Waffle

# create simple dummy data
data = {'Kevin': 10, 'Joseph': 7, 'Yan': 8}

# Basic waffle
plt.figure(
  FigureClass=Waffle,
  rows=5,
  columns=20,
  values=data,
  legend={'loc': 'upper left', 'bbox_to_anchor': (1.05, 1)},
)
plt.show()

Waffle chart with PyWaffle

The examples below should guide you through the Waffle class usage. It starts with a very basic example and then provides hints on how to apply usual customization like using icons or showing percentages in the legend.

Basic waffle chart

Waffle chart with Icons instead of squares

Waffle chart with proportions in the legend.

Waffle chart with additionnal grouping and title

Simple stacked waffle bar chart

Vertically stacked waffle bar chart

Custom stacked waffle bar chart: legend, icons and colors

Best examples

The web is full of astonishing charts made by awesome bloggers, (often using R). The Python graph gallery tries to display (or translate from R) some of the best creations and explain how their source code works. If you want to display your work here, please drop me a word or even better, submit a Pull Request!

Small multiples of waffle charts with nice annotations

Horizontal waffle charts with custom fonts and colors

Waffle chart as a time series with nice style

Waffle chart as a time series with clean labels and annotations