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:
1 parent
fcc01d2d68
commit
4b937da95b
6 files changed
+31
-23
No files matched your search
@@ -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é>
|
||||
|
||||
@@ -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)
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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))
|
||||
|
||||
|
||||
|
||||
Reference in new issue
Block a user