93 lines
4.4 KiB
Python
93 lines
4.4 KiB
Python
"""PNG plot of the series of an "advanced" export, for the diagnostic agent to look at.
|
|||
|
|
|
||
|
|
Usage: .venv/bin/python tools/scripts/plot.py data/PS_DES_COUDRES/
|
||
|
|
[--sensors SENSOR_A,SENSOR_B] [--columns error_value,corr_x,corr_y] [--start ...] [--end ...]
|
||
|
|
[--zone START/END ...] [--out FOLDER]
|
||
|
|
One panel per column, one curve per sensor, UTC times; each --zone is greyed. Columns: error_value, corr_x, corr_y,
|
||
|
|
relative_x, relative_y, x, y, sigma0, reproj_err, and the six image quality metrics (peak to snr, raw values; against a calm reference: quality.py).
|
||
|
|
Prints the path of the PNG (out/diagnostic/, or --out: the report's folder, for an evidence figure).
|
||
|
|
"""
|
||
|
|
import argparse
|
||
|
|
import os
|
||
|
|
import sys
|
||
|
|
|
||
|
|
import matplotlib
|
||
|
|
|
||
|
|
matplotlib.use("Agg")
|
||
|
|
import matplotlib.dates as mdates # noqa: E402
|
||
|
|
import matplotlib.pyplot as plt # noqa: E402
|
||
|
|
|
||
|
|
from data import filter_window, is_reference, load, parse_time # noqa: E402
|
||
|
|
from summary import QUALITY # noqa: E402
|
||
|
|
|
||
|
|
COLUMNS = ("error_value", "corr_x", "corr_y", "relative_x", "relative_y", "x", "y", "sigma0", "reproj_err")
|
||
|
|
|
||
|
|
|
||
|
|
def zone(text):
|
||
|
|
"""'2026-10-13T01:00Z/2026-10-13T03:00Z' -> (start, end)."""
|
||
|
|
start, sep, end = text.partition("/")
|
||
|
|
if not sep:
|
||
|
|
raise argparse.ArgumentTypeError(f"invalid zone: {text!r} (e.g. 2026-10-13T01:00Z/2026-10-13T03:00Z)")
|
||
|
|
return parse_time(start), parse_time(end)
|
||
|
|
|
||
|
|
|
||
|
|
def bound(t, default):
|
||
|
|
return t.strftime("%Y%m%dT%H%MZ") if t else default
|
||
|
|
|
||
|
|
|
||
|
|
def main():
|
||
|
|
a = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
|
||
|
|
a.add_argument("folder")
|
||
|
|
a.add_argument("--sensors", help="comma-separated list (default: all)")
|
||
|
|
a.add_argument("--columns", default="error_value,corr_x,corr_y")
|
||
|
|
a.add_argument("--start", type=parse_time)
|
||
|
|
a.add_argument("--end", type=parse_time)
|
||
|
|
a.add_argument("--zone", type=zone, action="append", default=[], help="window to grey, START/END (repeatable)")
|
||
|
|
a.add_argument("--out", default=os.path.join("out", "diagnostic"), help="folder of the PNG")
|
||
|
|
o = a.parse_args()
|
||
|
|
|
||
|
|
by = load(o.folder)
|
||
|
|
if not by:
|
||
|
|
sys.exit(f'No "advanced" export in {o.folder} (see inventory.py).')
|
||
|
|
names = o.sensors.split(",") if o.sensors else sorted(by, key=lambda s: (not is_reference(by[s]), s))
|
||
|
|
columns = o.columns.split(",")
|
||
|
|
for requested, known, what in ((names, by, "sensors"), (columns, COLUMNS + QUALITY, "columns")):
|
||
|
|
missing = [x for x in requested if x not in known]
|
||
|
|
if missing:
|
||
|
|
sys.exit(f"Unknown {what}: {', '.join(missing)}. Known: {', '.join(sorted(known))}.")
|
||
|
|
series = {s: filter_window(by[s], o.start, o.end) for s in names}
|
||
|
|
if not any(series.values()):
|
||
|
|
sys.exit("No measurement in the requested window.")
|
||
|
|
empty = [c for c in columns if all(m[c] is None for s in names for m in series[s])]
|
||
|
|
if len(empty) == len(columns):
|
||
|
|
sys.exit(f"Nothing to plot: {', '.join(columns)} empty for these sensors in the window.")
|
||
|
|
if empty:
|
||
|
|
print(f"Empty panels (no value for these sensors): {', '.join(empty)}")
|
||
|
|
|
||
|
|
fig, axes = plt.subplots(len(columns), 1, sharex=True, figsize=(14, 3.2 * len(columns)), squeeze=False)
|
||
|
|
tab20 = plt.get_cmap("tab20").colors
|
||
|
|
colors = tab20[::2] + tab20[1::2] # dark shades first: two neighbouring sensors do not share a hue
|
||
|
|
for ax, col in zip(axes[:, 0], columns):
|
||
|
|
for i, s in enumerate(names):
|
||
|
|
ms = series[s] # an empty value becomes NaN: the curve breaks instead of bridging the gap
|
||
|
|
ax.plot([m["t"] for m in ms], [float("nan") if m[col] is None else m[col] for m in ms], ".-", ms=2, lw=0.7,
|
||
|
|
color=colors[i % len(colors)], label=s)
|
||
|
|
for start, end in o.zone:
|
||
|
|
ax.axvspan(start, end, color="0.85", zorder=0)
|
||
|
|
ax.set_ylabel(col)
|
||
|
|
ax.grid(alpha=0.3)
|
||
|
|
axes[0, 0].legend(loc="upper left", bbox_to_anchor=(1.0, 1.0), fontsize=8)
|
||
|
|
axes[-1, 0].xaxis.set_major_formatter(mdates.DateFormatter("%d/%m\n%H:%MZ"))
|
||
|
|
station = os.path.basename(os.path.normpath(o.folder))
|
||
|
|
fig.suptitle(f"{station}: {', '.join(columns)} (UTC times)")
|
||
|
|
|
||
|
|
os.makedirs(o.out, exist_ok=True)
|
||
|
|
who = "-".join(names) if o.sensors else "all"
|
||
|
|
path = os.path.join(o.out, f"{station}_{'-'.join(columns)}_{who}_"
|
||
|
|
f"{bound(o.start, 'start')}_{bound(o.end, 'end')}.png")
|
||
|
|
fig.savefig(path, dpi=100, bbox_inches="tight")
|
||
|
|
print(path)
|
||
|
|
|
||
|
|
|
||
|
|
if __name__ == "__main__":
|
||
|
|
main()
|