README.md

Deprecation

dufte as a stand-alone module has been deprecated and merged into mplx.

---

Da kiekste, wa?

This package creates clean and beautiful plots that work on light and dark backgrounds. Inspired by the work of Edward Tufte.

To use, install with

pip install dufte

and simply select the dufte style:

import dufte
import matplotlib.pyplot as plt

# global setting:
plt.style.use(dufte.style)

# with a context manager:
with plt.style.context(dufte.style_bar):
    # ...
    pass

Check out dufte.legend(), dufte.ylabel(), and dufte.show_bar_values() for more duftiness.

Comparison with default Matplotlib

See here for how to create the below plots.

matplotlib	dufte with dufte.legend()

matplotlib	dufte	dufte with dufte.show_bar_values()

Further reading and other styles

• Remove to improve: data-ink ratio

  

• Remove to improve: Line Graph Edition

• Show the Data - Maximize the Data Ink Ratio

• Randal S. Olson's blog entry

• prettyplotlib

• Wikipedia: Chartjunk

Other styles

• John Garrett, Science Plots
• Dominik Haitz, Cyberpunk style
• Dominik Haitz, Matplotlib stylesheets
• Carlos da Costa, The Grand Budapest Hotel
• Danny Antaki, vaporwave aesthetics
• QuantumBlack Labs, QuantumBlack

Projects using dufte:

• perfplot
• stargraph

Background

The position $x_i$ of the line annotations is computed as the solution of a non-negative least-squares problem

$$\begin{align} \frac{1}{2}\sum_i (x_i - t_i)^2 \to \min_x,\\\ (x_i - x_j)^2 \ge a^2 \quad \forall i,j. \end{align}$$

where $a$ is the minimum distance between two entries and $t_i$ is the target position.