dufte 0.2.24

Clean matplotlib plots

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, simply select the dufte style. Check out dufte.legend() and dufte.ylabel() for more duftness.

import matplotlib.pyplot as plt
import dufte
import numpy as np

plt.style.use(dufte.style)

rng = np.random.default_rng(0)

x0 = np.linspace(0.0, 3.0, 100)
y0 = x0 / (x0 + 1)
y0 += 0.1 * rng.random(len(y0))
plt.plot(x0, y0, label="no balacing")

x1 = np.linspace(0.0, 3.0, 100)
y1 = 1.5 * x1 / (x1 + 1)
y1 += 0.1 * rng.random(len(y1))
plt.plot(x1, y1, label="CRV-27")

x2 = np.linspace(0.0, 3.0, 100)
y2 = 1.6 * x2 / (x2 + 1)
y2 += 0.1 * rng.random(len(y2))
plt.plot(x2, y2, label="CRV-27*")

dufte.ylabel("ylabel")
dufte.legend()

plt.show()

The bar plot is created with dufte.style_bar here and dufte.show_bar_values(). Note the use of context instead of style.use(); both are appropriate.

import matplotlib.pyplot as plt
import dufte


with plt.style.context(dufte.style_bar):
    labels = ["Australia", "Brazil", "China", "Germany", "Mexico", "United\nStates"]
    vals = [21.65, 24.5, 6.95, 8.40, 21.00, 8.55]
    xpos = range(len(vals))
    plt.bar(xpos, vals)
    plt.xticks(xpos, labels)
    dufte.show_bar_values("{:.2f}")
    plt.title("average temperature [°C]")
    plt.show()

Further reading:

• 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

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.

Testing

To run the dufte unit tests, check out this repository and type

pytest

License

This software is published under the GPLv3 license.