"""Maquette de la page Explore avec les onglets View et Diagnosis (D-053, D-054) ; spec : vues-deplacements/maquette/spec.md. Lit l'export « advanced » d'un dossier de station avec l'outil donnees.py de l'agent (positions, error_value) et son export horaire (déplacements en mm), liste les images et les captures de la plateforme, puis remplit explore_template.html. Écrit out/vues_deplacements_.html et l'ouvre dans le navigateur. Usage : python3 vues-deplacements/maquette/explore.py [dossier de station] (défaut : le cas NORDEND d'octobre 2026) """ import csv import html import json import os import statistics import sys from datetime import datetime from pathlib import Path from urllib.parse import quote from zoneinfo import ZoneInfo HERE = Path(__file__).resolve().parent ROOT = HERE.parents[1] OUT = ROOT / "out" DEFAULT = ROOT / "vues-deplacements" / "cas" / "2026-10_NORDEND" / "NORDEND" sys.path.insert(0, str(ROOT / "src")) sys.path.insert(0, str(ROOT / "agents" / "diagnostic" / "outils")) from common.page import AUTOSCALE_Y_JS, open_html # noqa: E402 (bascule seule sur .venv si plotly manque) import donnees # noqa: E402 (lecture des exports, bibliothèque standard) COLUMNS = ("error_value",) # grandeurs de l'export « advanced » gardées pour la page, en plus de x, y KINDS = ("global_ref", "ref", "target") # ordre des lignes : références de la compensation, local reference, cibles MARGIN_PX = 150 # marge autour des capteurs, zoom de départ de l'image (spec §1) HOURLY_TZ = ZoneInfo("Europe/Zurich") # horodatage de l'export horaire : heure suisse, sans fuseau (docs/domaine/colonnes-des-deplacements.md) CAPTURES = {"time_series": ("01", "02", "03"), "advanced": ("04", "05")} # captures de cas//plateforme/ par onglet def hourly(path): """Export horaire -> déplacements en mm de chaque cible, heure par heure, en UTC (début de l'heure) ; les références n'y sont pas.""" with open(path, newline="") as f: rows = list(csv.DictReader(f)) if not rows: return {"times": [], "sensors": {}} num = lambda v: float(v) if v and v.strip() else None # noqa: E731 names = sorted(c[:-len("_vertical_displacement")] for c in rows[0] if c.endswith("_vertical_displacement")) times = [datetime.fromisoformat(r["timestamp"]).replace(tzinfo=HOURLY_TZ) for r in rows] return {"times": [donnees.iso(t) for t in times], "sensors": {n: {"h": [num(r[f"{n}_horizontal_displacement"]) for r in rows], "v": [num(r[f"{n}_vertical_displacement"]) for r in rows]} for n in names}} def url(path): """Chemin -> URL relative depuis out/, où la page est écrite.""" return quote(Path(os.path.relpath(path, OUT)).as_posix()) def build(folder): """Dossier de station -> données de la page ; quitte avec un message s'il n'a pas d'export « advanced ».""" files = donnees.trouver(str(folder)) if not files["advanced"]: sys.exit(f"Pas d'export « advanced » dans {folder}") mesures = donnees.charger(str(folder)) minute = lambda t: t.replace(second=0, microsecond=0) # noqa: E731 (instants à la minute, comme donnees.iso) instants = sorted({minute(m["t"]) for ms in mesures.values() for m in ms}) col = {t: j for j, t in enumerate(instants)} order = lambda s: (KINDS.index(mesures[s][0]["pattern_type"]) if mesures[s][0]["pattern_type"] in KINDS # noqa: E731 else len(KINDS), s) sensors = [] for name in sorted(mesures, key=order): ms = mesures[name] row = {c: [None] * len(instants) for c in ("x", "y") + COLUMNS} for m in ms: for c in row: row[c][col[minute(m["t"])]] = m[c] xs, ys = [v for v in row["x"] if v is not None], [v for v in row["y"] if v is not None] sensors.append({"name": name, "kind": ms[0]["pattern_type"], "threshold": ms[0]["error_threshold"], "x": row["x"], "y": row["y"], "home": [statistics.median(xs), statistics.median(ys)] if xs and ys else None, "values": {c: row[c] for c in COLUMNS}}) homes = [s["home"] for s in sensors if s["home"]] view = {a: [min(h[k] for h in homes) - MARGIN_PX, max(h[k] for h in homes) + MARGIN_PX] for k, a in enumerate(("x", "y"))} if homes else None images = sorted(({"t": donnees.iso(t), "src": url(p)} for p in files["images"] if (t := donnees.heure_image(p))), key=lambda im: im["t"]) plateforme = Path(folder).resolve().parent / "plateforme" captures = {tab: [url(p) for n in prefixes for p in sorted(plateforme.glob(f"{n}_*"))[:1]] for tab, prefixes in CAPTURES.items()} return {"platform": Path(files["advanced"][0]).name.split("_advanced_")[0], "times": [donnees.iso(t) for t in instants], "sensors": sensors, "images": images, "view": view, "captures": captures, "folder": Path(os.path.relpath(Path(folder).resolve(), ROOT)).as_posix(), # pour la demande à l'agent "hourly": hourly(files["horaire"][0]) if files["horaire"] else {"times": [], "sensors": {}}} def page(folder): """Dossier de station -> chemin de la page écrite dans out/.""" data = build(folder) text = (HERE / "explore_template.html").read_text() text = text.replace("", html.escape(data["platform"])) text = text.replace("/*DATA*/null", json.dumps(data).replace(" 1 else DEFAULT) print(out) open_html(out)