Light and dark mode

Every plotting function takes dark: bool = True – the whole figure (pitch, chart chrome, team colors) switches between the Waltzing Analytics dark and light house-style palettes in wa_setpieces.viz.theme with that one argument: navy canvas with a coral accent for dark, paper canvas with an amber accent for light – see the module docstring for exactly which colors are WA’s own brand values versus derived to fill out an 8-color categorical set.

The two-team charts (plot_team_comparison() and friends) use a fixed teal-then-blue team_colors convention – the first team passed (or the first row in the summary/report, if team_order isn’t given) is always teal, the second always blue, consistently across a whole report. subtitle and footer are optional: a muted line under the title, and a small credit/source line in the bottom-right corner of the figure – never set by default, since a source credit belongs to whoever is publishing the chart.

from pathlib import Path

from wa_setpieces import delivery_locations, load_matches, set_piece_summary
from wa_setpieces.viz.plots import plot_delivery_map, plot_team_comparison

try:
    _here = Path(__file__).resolve().parent
except NameError:
    _here = Path.cwd()
DATA = _here.parent / "tests" / "data" / "sample_match.json"

events = load_matches(DATA)
corners = delivery_locations(events, "corner")
summary = set_piece_summary(events)

Dark mode (the default):

fig, ax = plot_delivery_map(
    corners, title="Corner deliveries", subtitle="Sample match · Delivery map",
    footer="Data: Opta", dark=True,
)

The same figure, light mode:

fig, ax = plot_delivery_map(
    corners, title="Corner deliveries", subtitle="Sample match · Delivery map",
    footer="Data: Opta", dark=False,
)

Team comparisons use a fixed teal/blue pairing in both modes:

fig, ax = plot_team_comparison(summary, metric="attempts", title="Attempts by set-piece type", dark=False)