"""Ce que rendent les outils de lecture sur une plage : une page HTML (texte imprimé + PNG). Usage : python3 aiguiser/voir.py data/NORDEND/ --debut 2026-09-01T00:00Z --fin 2026-09-04T00:00Z [--capteurs A,B,C] [--sortie D] Lance, avec les réglages du skill lire-les-donnees, inventaire, ensemble, resume, graphique et vignettes. La page est rangée dans out/voir/___/ ; la version est le hash git de agent-tools/ (« +modif » si le dossier a des changements non commités) : deux pages de versions différentes se comparent côte à côte. Sans --capteurs, les vignettes montrent les 3 capteurs qui s'écartent le plus de leur niveau habituel (error_value, en MAD) et le plus calme comme témoin. Rend ce que les outils rendent, aucun verdict. """ import argparse import html import os import re import statistics import subprocess import sys RACINE = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), "..")) OUTILS = os.path.join(RACINE, "agent-tools") sys.path.insert(0, OUTILS) from donnees import charger, est_reference, filtrer, heure_image, instant, iso, trouver # noqa: E402 PYTHON = os.path.join(RACINE, ".venv", "bin", "python") if not os.path.exists(PYTHON): PYTHON = sys.executable NB_IMAGES = 5 def version_outils(): sh = lambda *a: subprocess.run(["git", "-C", RACINE, *a], capture_output=True, text=True).stdout.strip() h = sh("rev-parse", "--short", "HEAD:agent-tools") return h + ("+modif" if sh("status", "--porcelain", "--", "agent-tools") else "") def ecarts(par, debut, fin): """Capteur -> plus grand écart d'error_value à sa médiane, en MAD, sur la fenêtre.""" out = {} for s, ms in par.items(): v = [m["error_value"] for m in filtrer(ms, debut, fin) if m["error_value"] is not None] if len(v) > 2: med = statistics.median(v) mad = statistics.median(abs(x - med) for x in v) or 1e-9 out[s] = max(abs(x - med) for x in v) / mad return out def vignettes(par, dossier, debut, fin, capteurs): heures = sorted(h for h in map(heure_image, trouver(dossier)["images"]) if h and debut <= h <= fin) if not heures: return None pas = max(len(heures) // NB_IMAGES, 1) heures = heures[::pas][:NB_IMAGES] if not capteurs: e = ecarts(par, debut, fin) classes = sorted(e, key=e.get) capteurs = classes[::-1][:3] + classes[:1] return ["--capteurs", ",".join(capteurs), "--heures", ",".join(iso(h) for h in heures)] def main(): a = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) a.add_argument("dossier") a.add_argument("--debut", required=True, type=instant) a.add_argument("--fin", required=True, type=instant) a.add_argument("--capteurs", help="capteurs des vignettes, séparés par des virgules") a.add_argument("--sortie", help="dossier de la page (défaut : out/voir/…)") o = a.parse_args() par = charger(o.dossier) if not par: sys.exit(f"Aucun export « advanced » dans {o.dossier}.") station = os.path.basename(os.path.normpath(o.dossier)) version = version_outils() sortie = o.sortie or os.path.join(RACINE, "out", "voir", f"{station}_{re.sub(r'[^0-9TZ]', '', iso(o.debut))}_" f"{re.sub(r'[^0-9TZ]', '', iso(o.fin))}_{version.replace('+', '-')}") os.makedirs(sortie, exist_ok=True) fenetre = ["--debut", iso(o.debut), "--fin", iso(o.fin)] cmds = [ ("inventaire", [PYTHON, f"{OUTILS}/inventaire.py", o.dossier, *fenetre]), ("ensemble", [PYTHON, f"{OUTILS}/ensemble.py", o.dossier, *fenetre, "--sortie", sortie]), ("resume error_value, 6 h", [PYTHON, f"{OUTILS}/resume.py", o.dossier, *fenetre, "--niveau", "fenetre", "--pas", "6h"]), ("graphique", [PYTHON, f"{OUTILS}/graphique.py", o.dossier, *fenetre, "--sortie", sortie]), ] v = vignettes(par, o.dossier, o.debut, o.fin, o.capteurs.split(",") if o.capteurs else None) if v: cmds.append(("vignettes", [PYTHON, f"{OUTILS}/vignettes.py", o.dossier, *v, "--sortie", sortie])) corps = [] for titre, cmd in cmds: r = subprocess.run(cmd, capture_output=True, text=True, cwd=RACINE) texte = (r.stdout + r.stderr).strip() pngs = [os.path.relpath(l, sortie) for l in r.stdout.splitlines() if l.endswith(".png") and os.path.exists(l)] texte = "\n".join(l for l in texte.splitlines() if not (l.endswith(".png") and os.path.exists(l))) corps.append(f"

{html.escape(titre)}{'' if r.returncode == 0 else ' (échec)'}

" f"

{html.escape(' '.join(os.path.relpath(c, RACINE) if os.path.isabs(c) and c.startswith(RACINE) else c for c in cmd[1:]))}

" f"
{html.escape(texte)}
" + "".join(f'' for p in pngs)) if not v: corps.append("

vignettes

Pas d'image dans la fenêtre.
") page = (f"{station} : outils de lecture" "" f"

{station} : ce que rendent les outils

" f"

{iso(o.debut)} → {iso(o.fin)} (UTC) · outils {version}

" + "".join(corps)) chemin = os.path.join(sortie, "index.html") with open(chemin, "w") as f: f.write(page) print(chemin) if __name__ == "__main__": main()