Pluvium-500 / scripts /chart_cyclone.py
Sigmandndnns's picture
Pluvium: code, model card, papers and benchmarks
fbb9a05 verified
Raw History Blame Contribute Delete
3.51 kB
# Copyright 2026 Nathan. Apache-2.0.
"""Track error by lead for the early guidance: Pluvium Cyclone against the National Hurricane Center's official
forecast and its two consensus aids, on the forecasts all four made. One panel per 2025 season.
python scripts/chart_cyclone.py cyclone.json docs/img/cyclone_track_error.png
"""
import json
import sys
from pathlib import Path
import matplotlib
matplotlib.use("Agg")
import matplotlib.pyplot as plt
SURFACE, INK, INK2, MUTED, GRID, AXIS = "#fcfcfb", "#0b0b0b", "#52514e", "#898781", "#e1e0d9", "#c3c2b7"
SERIES = [("PLVI", "Pluvium Cyclone", "#2a78d6"), ("OFCL", "NHC official forecast", "#eb6834"),
("TVCN", "NHC consensus TVCN", "#1baf7a"), ("HCCA", "NHC corrected consensus HCCA", "#eda100")]
PANELS = [("East Pacific 2025", "East Pacific 2025: the test season"),
("North Atlantic 2025", "North Atlantic 2025: a development season")]
result = json.loads(Path(sys.argv[1]).read_text())
out = Path(sys.argv[2])
plt.rcParams.update({"font.family": "DejaVu Sans", "font.size": 9, "axes.edgecolor": AXIS, "axes.labelcolor": INK2,
"xtick.color": MUTED, "ytick.color": MUTED, "text.color": INK})
fig, axes = plt.subplots(1, 2, figsize=(9.6, 3.9), sharey=True)
fig.patch.set_facecolor(SURFACE)
for ax, (key, title) in zip(axes, PANELS):
rows = result["seasons"][key]["homogeneous_early"]
leads = sorted(int(k) for k in rows)
ax.set_facecolor(SURFACE)
ends = []
for tech, label, color in SERIES:
ys = [rows[str(k)][tech] for k in leads]
ax.plot(leads, ys, color=color, lw=2, solid_joinstyle="round", solid_capstyle="round", zorder=3)
ax.plot(leads[-1], ys[-1], "o", ms=6, color=color, mec=SURFACE, mew=2, zorder=4)
ends.append((ys[-1], {"PLVI": "Pluvium", "OFCL": "Official"}.get(tech, tech), color))
ends.sort()
placed = []
for y, label, _ in ends: # end labels, nudged apart so they never collide
y_at = y if not placed or y - placed[-1] >= 9 else placed[-1] + 9
placed.append(y_at)
ax.text(leads[-1] + 3, y_at, label, fontsize=8, color=INK2, va="center")
ax.set_title(title, fontsize=10, color=INK, loc="left", pad=6)
ax.grid(axis="y", color=GRID, lw=0.8)
ax.set_axisbelow(True)
for side in ("top", "right", "left"):
ax.spines[side].set_visible(False)
ax.tick_params(length=0)
ax.set_xticks(leads)
ax.set_xlim(leads[0] - 4, leads[-1] + 26)
ax.set_xlabel("Hours ahead", color=INK2)
ax.text(leads[0], 0.96, f"{rows[str(leads[0])]['n']} forecasts at {leads[0]} h, {rows[str(leads[-1])]['n']} at {leads[-1]} h",
fontsize=8, color=MUTED, transform=ax.get_xaxis_transform(), va="top")
axes[0].set_ylabel("Mean track error, nautical miles", color=INK2)
axes[0].set_ylim(0, None)
handles = [plt.Line2D([], [], color=c, lw=2, marker="o", ms=6, mec=SURFACE, mew=2) for _, _, c in SERIES]
fig.legend(handles, [label for _, label, _ in SERIES], loc="upper left", ncol=4, frameon=False, fontsize=9,
bbox_to_anchor=(0.01, 1.0), handlelength=2.2)
fig.text(0.01, -0.02, "Early guidance (what is in hand at advisory time), on the forecasts all four made. Truth: the National "
"Hurricane Center's best tracks. Lower is better.", fontsize=8, color=MUTED)
fig.tight_layout(rect=(0, 0.01, 1, 0.92))
out.parent.mkdir(parents=True, exist_ok=True)
fig.savefig(out, dpi=200, facecolor=SURFACE, bbox_inches="tight")
print("saved", out)