V1.72.0 is out!

[cvanelteren]

This release is marked by the addition of Sankey diagrams and ternary plots (powered by mpltern).

Sankey diagrams

Sankey diagrams are flow charts that visualize the movement of quantities (like energy, money, or users) between different stages or categories, where the width of the connecting arrows is proportional to the flow's magnitude, making major transfers visually obvious. Named after Captain Sankey, they effectively show distributions, energy efficiency, material flows, user journeys, and budget breakdowns, helping to identify dominant paths within a system

Ternary plots

A ternary plot (also known as a ternary graph, triangle plot, or simplex plot) is a barycentric plot on an equilateral triangle. It is used to represent the relative proportions of three variables that sum to a constant—usually 100% or 1.0.

Because the three variables are interdependent (if you know the value of two, the third is automatically determined), a 3D dataset can be visualized in a 2D space without losing information. The plot is commonly used in field such as (evollutionary) game theory. We are harnessing the power of mpltern by wrapping their axes ax external. This gives the best of both worlds where the functionality of the ternary plot is provided by mpltern while allow thing formatting flexibility of UltraPlot.

Note that this feature is introduced now, but marked as experimental. The underlying changes are embedding a different axes inside a container, and there are likely for bugs to emerge from this -- so any feedback or reports are highly appreciated.

snippet

import mpltern


from mpltern.datasets import get_shanon_entropies, get_spiral
import ultraplot as uplt, numpy as np
import networkx as nx

t, l, r, v = get_shanon_entropies()


layout = [[1, 3], [2, 3]]
fig, ax = uplt.subplots(layout, projection=["cartesian", "ternary", "cartesian"], share = 0, hspace = 10)

# Show some noise
ax[0].imshow(np.random.rand(10, 10), cmap = "Fire", colorbar = "r",
    colorbar_kw = dict(title = "Random\nnoise", length = 0.333, align = "t"),)


# Ternary plot mock data
vmin = 0.0
vmax = 1.0
levels = np.linspace(vmin, vmax, 7)
cs = ax[1].tripcolor(t, l, r, v, cmap="lapaz_r", shading="flat", vmin=vmin, vmax=vmax)
ax[1].plot(*get_spiral(), color="white", lw=1.25)
colorbar = ax[1].colorbar(
    cs,
    loc="b",
    align="c",
    title="Entropy",
    length=0.33,
)

# Show a network
g = nx.random_geometric_graph(101, 0.2, seed = 1)
nc = []
min_deg = min(g.degree(), key=lambda x: x[1])[1]
max_deg = max(g.degree(), key=lambda x: x[1])[1]
for node in g.nodes():
    intensity = (g.degree(node) - min_deg)/ (max_deg - min_deg)
    nc.append(uplt.Colormap("plasma")(intensity))

ax[2].graph(g, node_kw = dict(node_size = 32, node_color = nc))
ax.format(title = ["Hello", "there", "world!"], abc = True)
fig.show()

What's Changed

• Add two files and one folder from doc building to git ignoring by @gepcel in Add two files and one folder from doc building to git ignoring #482
• Refactor format in sensible blocks by @cvanelteren in Refactor format in sensible blocks #484
• Fix: Correct label size calculation in _update_outer_abc_loc by @cvanelteren in Fix: Correct label size calculation in _update_outer_abc_loc #485
• Fix: Isolate format() scope for insets and panel by @cvanelteren in Fix: Isolate format() scope for insets and panel #486
• Fix: Move locator back to top level by @cvanelteren in Fix: Move locator back to top level #490
• Fix baseline cache invalidation for PR comparisons by @cvanelteren in Fix baseline cache invalidation for PR comparisons #492
• Fix/baseline cache refresh 2 by @cvanelteren in Fix/baseline cache refresh 2 #493
• Feature: Sankey diagrams by @cvanelteren in Feature: Sankey diagrams #478
• Feature: Add container to encapsulate external axes by @cvanelteren in Feature: Add container to encapsulate external axes #422
• Fix font lazy load by @cvanelteren in Fix font lazy load #498
• Fix test_get_size_inches_rounding_and_reference_override by @cvanelteren in Fix test_get_size_inches_rounding_and_reference_override #499
• Remove -x from mpl pytest runs by @cvanelteren in Remove -x from mpl pytest runs #500
• Ci test selection by @cvanelteren in Ci test selection #502
• Update GitHub workflows by @cvanelteren in Update GitHub workflows #505
• CI: make baseline comparison non-blocking by @cvanelteren in CI: make baseline comparison non-blocking #508
• CI: remove redundant pytest run by @cvanelteren in CI: remove redundant pytest run #509
• Fix log formatter tickrange crash by @cvanelteren in Fix log formatter tickrange crash #507
• Add return to test_colorbar_log_formatter_no_tickrange_error by @cvanelteren in Add return to test_colorbar_log_formatter_no_tickrange_error  #510
• CI: set default mpl image tolerance by @cvanelteren in CI: set default mpl image tolerance #511
• Fix pytest-mpl default tolerance hook by @cvanelteren in Fix pytest-mpl default tolerance hook #512
• Delegate external axes methods with guardrails by @cvanelteren in Delegate external axes methods with guardrails #514
• Fix ternary tri* delegation and add example by @cvanelteren in Fix ternary tri* delegation and add example #513

Full Changelog: v1.71.0...v1.72.0