Fix review findings in the diagnostic agent tools and instructions

Inclusive --fin at the displayed minute, UTC for naive time_utc, neutral examples,
5-significant-digit values, 'vide' vs '-' cells, no empty or gap-bridging plots,
timestamped report names, and an up-to-date CLAUDE.md next step.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-14 15:35:44 +02:00
1 parent fcc01d2d68
commit 4b937da95b
6 files changed
+31 -23

No files matched your search

+4 -4
View File
@@ -36,7 +36,7 @@ Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdi
| `.venv/bin/python agents/diagnostic/outils/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T]` | Un PNG des séries ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau |
| `ls <dossier>/images/`, puis Read sur `<AAAAMMJJ>T<HHMM>Z_*.jpg` | L'image de la caméra à cette heure (UTC). Les colonnes `x` et `y` (pixels) situent chaque capteur sur l'image |
Instants : `2026-10-13T23:00Z` (une heure sans fuseau est lue en UTC). Bash ne sert qu'à lancer ces outils, `ls`, `grep`, `pdftotext` et `date`, une commande simple par appel (pas de boucle `for`) : les permissions sont accordées commande par commande. N'écris aucun autre script.
Instants : `2026-01-01T00:00Z` (une heure sans fuseau est lue en UTC ; `--fin` inclut la minute indiquée). Bash ne sert qu'à lancer ces outils, `ls`, `grep`, `pdftotext` et `date`, une commande par appel, sans boucle `for` (un tube vers `grep` est permis) : les permissions sont accordées commande par commande. N'écris aucun autre script.
## 4. Déroulé
@@ -68,7 +68,7 @@ Instants : `2026-10-13T23:00Z` (une heure sans fuseau est lue en UTC). Bash ne s
## 6. Le rapport
Écris-le dans `agents/diagnostic/rapports/<AAAA-MM-JJ>_<STATION>.md` (date du jour en UTC : `date -u +%F` ; station : nom du dossier). Avec une question, ajoute un sujet court : `<AAAA-MM-JJ>_<STATION>_<sujet>.md`. Si le fichier existe, ajoute `_2`, `_3`…
Écris-le dans `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>.md` (instant présent en UTC : `date -u +%Y-%m-%dT%H%MZ` ; station : nom du dossier). Avec une question, ajoute un sujet court : `<AAAA-MM-JJTHHMMZ>_<STATION>_<sujet>.md`. Ne liste pas `rapports/` : l'heure dans le nom suffit à éviter un doublon.
```markdown
# Diagnostic <STATION> : <scan | sujet de la question>
@@ -88,7 +88,7 @@ Instants : `2026-10-13T23:00Z` (une heure sans fuseau est lue en UTC). Bash ne s
## Événements
### E1 : <titre court> (<début> → <fin> UTC)
- **Classification** : une de : *monitored-object motion*, *camera/reference compensation event*, *weak/unstable reference solution*, *model mismatch/parallax*, *target-local degradation*, problème système, rien d'anormal, indéterminé
- **Classification** : la principale (une seconde si elle s'applique aussi), parmi : *monitored-object motion*, *camera/reference compensation event*, *weak/unstable reference solution*, *model mismatch/parallax*, *target-local degradation*, problème système, rien d'anormal, indéterminé
- **Cause probable** : buée ou eau | occlusion | turbulence | éclairage | inconnue (seulement pour une cause externe à l'ouvrage)
- **Couche** : la couche de la chaîne de dépendance (section 4 du contexte support)
- **Niveau de preuve** : …
@@ -97,7 +97,7 @@ Instants : `2026-10-13T23:00Z` (une heure sans fuseau est lue en UTC). Bash ne s
- **Réfutation** : hypothèse principale ; fait cherché pour la contredire ; résultat (`<commande>`)
- **Alternatives** : autres explications, et pourquoi elles ne sont pas écartées
- **Inconnus** : …
- **Prochaine vérification** : la plus discriminante
- **Prochaine vérification** : la plus discriminante : une donnée à obtenir ou une observation à faire par un humain ; pas de nouveau réglage chiffré (seuil) sans source
## Constats permanents
- <ce qui dure toute la période, ex. un capteur toujours rejeté>
+5 -4
View File
@@ -52,7 +52,7 @@ def charger(dossier):
with open(chemin, newline="") as f:
for r in csv.DictReader(f):
m = {c: _nombre(r[c]) for c in NUM}
m["t"] = datetime.fromisoformat(r["time_utc"]).astimezone(timezone.utc)
m["t"] = instant(r["time_utc"])
m["pattern_type"] = r["pattern_type"]
par.setdefault(r["sensor_name"], {})[m["t"]] = m
return {s: [d[t] for t in sorted(d)] for s, d in par.items()}
@@ -69,8 +69,9 @@ def rejetee(m):
def filtrer(mesures, debut, fin):
"""Mesures entre debut et fin inclus ; None = pas de borne."""
return [m for m in mesures if (debut is None or m["t"] >= debut) and (fin is None or m["t"] <= fin)]
"""Mesures entre debut et fin inclus, à la minute près (comme iso() les affiche) ; None = pas de borne."""
return [m for m in mesures if (debut is None or m["t"] >= debut)
and (fin is None or m["t"].replace(second=0, microsecond=0) <= fin)]
def heure_image(chemin):
@@ -80,7 +81,7 @@ def heure_image(chemin):
def instant(texte):
"""'2026-10-13T23:00Z' ou '2026-10-13 23:00' -> datetime UTC ; une heure sans fuseau est lue en UTC."""
"""'2026-01-01T00:00Z' ou '2026-01-01 00:00' -> datetime UTC ; une heure sans fuseau est lue en UTC."""
t = datetime.fromisoformat(texte)
return t.astimezone(timezone.utc) if t.tzinfo else t.replace(tzinfo=timezone.utc)
+8 -3
View File
@@ -1,7 +1,7 @@
"""Graphique PNG des séries d'un export « advanced », pour que l'agent de diagnostic les regarde.
Usage : .venv/bin/python agents/diagnostic/outils/graphique.py data/PS_DES_COUDRES/
[--capteurs REF_G,REF_D] [--colonnes error_value,corr_x,corr_y] [--debut ...] [--fin ...]
[--capteurs CAPTEUR_A,CAPTEUR_B] [--colonnes error_value,corr_x,corr_y] [--debut ...] [--fin ...]
Un panneau par colonne, une courbe par capteur, heures UTC. Imprime le chemin du PNG (out/diagnostic/).
"""
import argparse
@@ -45,14 +45,19 @@ def main():
series = {s: filtrer(par[s], o.debut, o.fin) for s in noms}
if not any(series.values()):
sys.exit("Aucune mesure dans la fenêtre demandée.")
vides = [c for c in colonnes if all(m[c] is None for s in noms for m in series[s])]
if len(vides) == len(colonnes):
sys.exit(f"Rien à tracer : {', '.join(colonnes)} vide(s) pour ces capteurs dans la fenêtre.")
if vides:
print(f"Panneaux vides (aucune valeur pour ces capteurs) : {', '.join(vides)}")
fig, axes = plt.subplots(len(colonnes), 1, sharex=True, figsize=(14, 3.2 * len(colonnes)), squeeze=False)
tab20 = plt.get_cmap("tab20").colors
couleurs = tab20[::2] + tab20[1::2] # teintes foncées d'abord : deux capteurs voisins ne partagent pas une teinte
for ax, col in zip(axes[:, 0], colonnes):
for i, s in enumerate(noms):
ms = [m for m in series[s] if m[col] is not None]
ax.plot([m["t"] for m in ms], [m[col] for m in ms], ".-", ms=2, lw=0.7,
ms = series[s] # une valeur vide devient NaN : la courbe s'interrompt au lieu de relier le trou
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=couleurs[i % len(couleurs)], label=s)
ax.set_ylabel(col)
ax.grid(alpha=0.3)
+9 -7
View File
@@ -1,11 +1,12 @@
"""Résumé chiffré compact des séries d'un export « advanced », pour l'agent de diagnostic.
Usage : python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ [--colonne error_value]
[--stat median|min|max] [--pas 1h] [--capteurs REF_G,REF_D] [--debut 2026-10-13T00:00Z] [--fin ...]
[--stat median|min|max] [--pas 1h] [--capteurs CAPTEUR_A,CAPTEUR_B] [--debut 2026-01-01T00:00Z] [--fin ...]
1. Niveau habituel de chaque capteur sur toute la période : médiane, MAD (écart absolu médian), min, max.
2. Tableau : une ligne par pas de temps (début du pas, UTC), une colonne par capteur, la statistique
choisie sur les mesures du pas. « rej » : toutes les mesures du pas sont rejetées ; « - » : aucune mesure.
choisie sur les mesures du pas. « rej » : toutes les mesures du pas sont rejetées ; « vide » : des mesures,
mais la colonne est vide (ex. reproj_err d'une cible) ; « - » : aucune mesure.
Rend des valeurs, pas de verdict.
"""
import argparse
@@ -62,7 +63,7 @@ def main():
sys.exit("Aucune mesure dans la fenêtre demandée.")
print(f"Colonne : {o.colonne}. Niveau habituel sur toute la période (mesures non vides) :")
print(f"{'capteur':10} {'n':>5} {'médiane':>9} {'MAD':>8} {'min':>9} {'max':>9}")
print(f"{'capteur':10} {'n':>5} {'médiane':>10} {'MAD':>10} {'min':>10} {'max':>10}")
for s in noms:
v = valeurs(par[s], o.colonne)
if not v:
@@ -70,19 +71,20 @@ def main():
continue
med = statistics.median(v)
mad = statistics.median(abs(x - med) for x in v)
print(f"{s:10} {len(v):5} {med:9.4f} {mad:8.4f} {min(v):9.4f} {max(v):9.4f}")
print(f"{s:10} {len(v):5} {med:10.5g} {mad:10.5g} {min(v):10.5g} {max(v):10.5g}")
print(f"\n{o.stat} de {o.colonne} par pas de {o.pas} (début du pas, UTC) :")
print(f"{'début':17} " + " ".join(f"{s:>8}" for s in noms))
print("rej : mesures du pas toutes rejetées ; vide : colonne vide ; - : aucune mesure")
print(f"{'début':17} " + " ".join(f"{s:>9}" for s in noms))
for k in sorted(cases):
cellules = []
for s in noms:
ms = cases[k].get(s, [])
v = valeurs(ms, o.colonne)
if v:
cellules.append(f"{STATS[o.stat](v):8.3f}")
cellules.append(f"{STATS[o.stat](v):9.5g}")
else:
cellules.append(f"{'rej' if ms and all(map(rejetee, ms)) else '-':>8}")
cellules.append(f"{'-' if not ms else 'rej' if all(map(rejetee, ms)) else 'vide':>9}")
print(f"{iso(k):17} " + " ".join(cellules))