Presentations for the client: Sandouville, no data-gap slide, settlements in corr_y (D-127)
The three October decks (BREITHORN, MICHIGAN, NEBRASKA) no longer criticise the system: facts and their external cause only. Figures redrawn in corr_y (figure-y.py), BREITHORN parallax kept. Sources and PDFs named after the station; the charter's draft stamp reads "Sandouville". Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
efbc5f15d7
commit
85e590762b
19 files changed
+6163
-6148
No files matched your search
@@ -12,6 +12,11 @@ Modèle à suivre : `modele.typ` (BREITHORN, octobre 2026, validé dans sa struc
|
||||
|
||||
## Ce que veut l'utilisateur (2026-11-03)
|
||||
|
||||
- **Une présentation pour le client, qui vend le système** (D-127) : on ne critique pas notre propre système, on ne s'incrimine pas. Pas de « mal compensé », « la correction ne le compense plus correctement », « la redondance est perdue », « les courbes sont moins fiables », « une seule correction ne peut pas toutes les compenser ». Dire le fait et sa cause extérieure : « REFPOU22 n'est plus visible ; la compensation continue sur deux références », « les courbes suivent ce mouvement commun de la caméra ».
|
||||
- **Les tassements d'abord, `corr_y`** : c'est ce que regarde le client. Les figures montrent le déplacement vertical (`corr_y`) ; `corr_x` seulement là où le phénomène ne se voit qu'en horizontal (BREITHORN : la parallaxe, gardée, dite par la géométrie : des cibles à 9 m, d'autres à 20 à 60 m, un même mouvement de la caméra ne se voit pas pareil sur toutes). Chiffrer la stabilité verticale quand elle se voit (médiane journalière de chaque cible sur le mois).
|
||||
- **Pas de diapositive sur un trou de données** (une nuit sans mesures), ni dans le résumé ni dans la conclusion.
|
||||
- **La conclusion** : ce qu'expliquent les variations des courbes et ce qui reste stable, pas « ce qui rend les mesures moins fiables ».
|
||||
|
||||
- **Aller droit aux faits** : pas de page « En bref », pas de description sous le titre ; la page de titre dit seulement que c'est un point de situation, la station et la période.
|
||||
- **Chaque diapositive se suffit** : elle montre le cas et donne le diagnostic, image à l'appui (l'image de la cause quand elle se voit : le véhicule, l'obstacle).
|
||||
- **Donner le diagnostic, pas une consigne** : jamais « à ignorer », « ne pas croire », « à ne pas lire comme ». Dire ce qui se passe et ce que cela implique, pour amener le client à la bonne conclusion : « le véhicule cache ces cibles ; leurs sauts tombent quand il est là, et tout revient au matin ».
|
||||
@@ -21,7 +26,7 @@ Modèle à suivre : `modele.typ` (BREITHORN, octobre 2026, validé dans sa struc
|
||||
- **Des légendes qui se lisent seules** : sous chaque graphique, dire ce que montre chaque panneau (la grandeur : déplacement horizontal `corr_x` ou vertical `corr_y`, tilt ou pan en degrés), les cibles, la période, ce que veulent dire le gris et les pointillés ; dans la figure aussi, l'axe à côté du nom de chaque cible. Le lecteur ne doit rien deviner.
|
||||
- **Les courbes, pas les cibles** : « les courbes de POUI19 dérivent », pas « POUI19 dérive » ; seul ce qui est mesuré dans l'image (« les cibles ne bougent pas dans l'image ») se dit des cibles.
|
||||
- **Nommer seulement ce qui se voit** : une tache lumineuse sur le véhicule, c'est « des reflets », pas « ses phares ».
|
||||
- **Une référence perdue** : avec deux références, dire que la redondance est perdue ; la correction « ne le compense plus correctement », pas « ne le compense plus ».
|
||||
- **Une référence perdue** : « la compensation continue sur les deux autres références » ; dater le saut commun à sa disparition.
|
||||
- **Un état qui dure depuis le début** (deux cibles trop proches) : le dater du début des données si les images le montrent, pas de la première étiquette ; dater à part le saut qu'il a provoqué (MICHIGAN : trop proches depuis le 3, saut le 5).
|
||||
- **Par mois** : la présentation couvre le mois du rapport (« c'est un rapport sur tout le mois d'octobre »). Si le rapport couvre moins, l'étendre d'abord (`/support <STATION> --du <1er> --au <dernier jour>`, ou un agent de support par station, en gardant le diagnostic déjà validé par l'expert).
|
||||
|
||||
@@ -32,23 +37,28 @@ Modèle à suivre : `modele.typ` (BREITHORN, octobre 2026, validé dans sa struc
|
||||
| 1 | `title-slide` | `kicker: [Point de situation]`, `title: [<STATION>]`, `subtitle: [Du <premier jour des données> au <dernier> <mois année>]` ; rien d'autre (ni description, ni image) |
|
||||
| 2 | `content-slide`, eyebrow « Résumé » | « Ce qui s'est passé en <mois> » : la chronologie, une ligne numérotée (`+`) par événement, dans l'ordre de leur premier jour : `+ #strong[<dates>] : <l'événement en quelques mots>.` |
|
||||
| 3 à n | une par événement, eyebrow « Événement <numéro du résumé> » | le titre de l'événement, 2 ou 3 puces (**Quand**, **Cibles** si utile, **Ce qu'on voit**), puis `#strong[Diagnostic] : …` en paragraphe ; l'image à droite |
|
||||
| n+1 | `content-slide` | « Conclusions », puis les puces : une par fait qui rend les mesures moins fiables, dans l'ordre d'importance, sans aucune instruction |
|
||||
| n+1 | `content-slide` | « Conclusions », puis les puces : ce qui reste stable, puis la cause de chaque variation, dans l'ordre d'importance, sans aucune instruction |
|
||||
| n+2 | `closing-slide` | « Nous restons à votre disposition », adresse par défaut |
|
||||
|
||||
- **Les événements** : un par constat du rapport ; quand un constat mêle deux phénomènes que l'utilisateur distingue, les séparer (BREITHORN : le mouvement de la caméra et la parallaxe, qui fait que certaines cibles le suivent). Plus de cinq événements : le lint signale « 6 bullets », c'est accepté pour le résumé.
|
||||
- **Diapositive d'événement** : `two-column-slide`, image à droite (`#image("images/x.png")` puis une légende `#emph[...]` d'une ligne). Ratio selon l'image (largeur / hauteur, dans l'en-tête du PNG) : ≥ 1,4 → `"40-60"` ; vignettes presque carrées (≤ 1,3) → `"60-40"`. Sans image (une nuit sans mesure) : `content-slide`, mêmes puces et diagnostic.
|
||||
- **Diapositive d'événement** : `two-column-slide`, image à droite (`#image("images/x.png")` puis une légende `#emph[...]` d'une ligne). Ratio selon l'image (largeur / hauteur, dans l'en-tête du PNG) : ≥ 1,4 → `"40-60"` ; vignettes presque carrées (≤ 1,3) → `"60-40"`. Sans image : `content-slide`, mêmes puces et diagnostic.
|
||||
- **Une image par événement**, la plus parlante : l'image de la cause si elle se voit, sinon la courbe, plage grisée.
|
||||
- `lang: "fr"` ; toute heure en UTC, dite ; les « on ne peut pas l'affirmer » du rapport restent dans le diagnostic (« la cause n'est pas établie »).
|
||||
|
||||
## 2. Les images
|
||||
|
||||
Toutes dans le dossier du rapport, à côté de `presentation.typ` : celles du rapport d'abord. Il en faut d'autres quand :
|
||||
Toutes dans le dossier du rapport, à côté de `<station>.typ` : celles du rapport d'abord. Il en faut d'autres quand :
|
||||
- **la cause se voit dans l'image de la caméra** et le rapport n'en a qu'une vignette : recadrages éclaircis côte à côte, d'abord un instant sans la cause, puis avec :
|
||||
```bash
|
||||
.venv/bin/python .claude/skills/presentation/image-de-la-cause.py data/<STATION> <x> <y> support/<dossier>/<nom>.png \
|
||||
20261028T1200Z="28.10 12:00 UTC : rien devant" 20261025T1200Z="25.10 12:00 UTC : un véhicule"
|
||||
```
|
||||
(x, y : le « centre du cadre » de la cible sur une vignette de `vignettes.py`). Les scènes intérieures sont sombres même de jour : chercher l'instant où la cause se voit le mieux (de jour, ou ses phares la nuit) ;
|
||||
- **les courbes en `corr_y`**, avec au besoin la caméra et la température au-dessus, les plages grisées et un trait pointillé (la perte d'une référence) ; le nom de chaque cible porte « (corr_y) » :
|
||||
```bash
|
||||
.venv/bin/python .claude/skills/presentation/figure-y.py data/<STATION> support/<dossier>/<nom>.png 2026-10-03T00:00Z 2026-11-01T00:00Z \
|
||||
--cam tilt,pan [--temp] --cibles A,B,C [--zone D/F ...] [--ligne T] [--hauteur 5] # --toutes : toutes les cibles, pour choisir
|
||||
```
|
||||
- **un événement de la caméra** : montrer le tilt **et** le pan (`camera/`, `median_tilt` et `median_pan`, deux panneaux, en degrés), et la rotation (`median_rotation`) quand c'est elle qui bouge (BREITHORN, nuits du 28 au 30.10 : la rotation en haut, les cibles en bas, les mêmes plages grisées) ; pour la parallaxe, le tilt en haut et les cibles en bas, chacune avec son axe dans la légende de la figure ;
|
||||
- **une figure à plusieurs panneaux** (tilt, pan, température, cibles) dans une colonne : la faire large (`figsize=(12.5, 6.4)`, rapport ≈ 2), sinon la diapositive déborde de 20 à 30 mm ;
|
||||
- **des vignettes** (`vignettes.py`) : leurs titres donnent déjà la cible et l'heure ; légende courte, « Au-dessus de chaque image : la cible et l'heure UTC ; croix rouge : le point mesuré. »
|
||||
@@ -57,25 +67,25 @@ Toute image nouvelle va dans le dossier du rapport, et se regarde avec Read avan
|
||||
|
||||
## 3. Écrire, compiler, vérifier
|
||||
|
||||
Le source est **`support/<dossier>/presentation.typ`**, versionné avec le rapport ; le partir de `modele.typ`, et ne référencer que des images du dossier, par leur nom seul (`#image("<nom>.png")`) : il se compile alors aussi sur place (VS Code, Tinymist), grâce au lien `brand/` à la racine du dépôt, que le script crée, et à `.vscode/settings.json`. L'utilisateur le modifie aussi lui-même (`run.md`, « Compiler la présentation »).
|
||||
Le source est **`support/<dossier>/<station>.typ`** (nom de la station en minuscules, `breithorn.typ`), versionné avec le rapport ; le partir de `modele.typ`, et ne référencer que des images du dossier, par leur nom seul (`#image("<nom>.png")`) : il se compile alors aussi sur place (VS Code, Tinymist), grâce au lien `brand/` à la racine du dépôt, que le script crée, et à `.vscode/settings.json`. L'utilisateur le modifie aussi lui-même (`run.md`, « Compiler la présentation »).
|
||||
|
||||
```bash
|
||||
bash .claude/skills/presentation/compiler.sh support/<dossier> # PDF dans support/<dossier>/presentation.pdf, et le nombre de débordements (doit être 0)
|
||||
bash .claude/skills/presentation/compiler.sh support/<dossier> # PDF dans support/<dossier>/<station>.pdf, et le nombre de débordements (doit être 0)
|
||||
cd ~/docfactory-presentation && python3 brand/tools/build.py <station>-situation --png # une image par page, dans build/, à regarder avec Read
|
||||
```
|
||||
|
||||
Le script copie le source et les images dans la fabrique (`documents/<station>-situation/`, une copie : ne pas la modifier), compile et rapporte le PDF. Une page qui déborde : `pdftotext -f N -l N support/<dossier>/presentation.pdf - | grep Overflow`.
|
||||
Le script copie le source et les images dans la fabrique (`documents/<station>-situation/`, une copie : ne pas la modifier), compile et rapporte le PDF. Une page qui déborde : `pdftotext -f N -l N support/<dossier>/<station>.pdf - | grep Overflow`.
|
||||
|
||||
- Typst ≥ 0.14 (`~/.local/bin`). Build qui refuse la charte (« added … :Zone.Identifier ») : `find ~/docfactory-presentation -name '*:Zone.Identifier' -delete`.
|
||||
- **Lint** : `bare-image` est attendu (pas de `#fig` dans le gabarit de présentation) ; `[budget]` : raccourcir (une puce ≤ 16 mots, le lint compte `;`, `:` et `#strong[Quand]`).
|
||||
- **Débordement** (« Overflow +N mm » en rouge ; la page : `pdftotext -f N -l N`) : puce ou diagnostic plus court, légende sur une ligne, ou ratio `"60-40"`. Jamais réduire la police.
|
||||
- **Noms à apostrophes** (COLH21', COLH20''') : `COLH20\'\'\'`, sinon Typst en fait des guillemets.
|
||||
- Pas de taille de police, de couleur, de `place`, `grid` ni `v` : la charte décide (`brand/` ne se modifie pas).
|
||||
- Regarder le résumé, chaque diapositive à image et la conclusion. « PROJET unversioned » en haut : normal, la fabrique n'est pas un dépôt git.
|
||||
- Regarder le résumé, chaque diapositive à image et la conclusion. En haut à droite, « Sandouville » : la ligne `#show regex("PROJET.*")` du modèle remplace le tampon « PROJET unversioned » de la charte (la fabrique n'est pas un dépôt git).
|
||||
|
||||
## 4. Rendre
|
||||
|
||||
Le PDF est déjà dans `support/<dossier>/presentation.pdf` : l'envoyer par `SendUserFile`, dire ce qui a changé ou a été laissé dans le rapport. Pas de commit avant la validation de l'utilisateur.
|
||||
Le PDF est déjà dans `support/<dossier>/<station>.pdf` : l'envoyer par `SendUserFile`, dire ce qui a changé ou a été laissé dans le rapport. Pas de commit avant la validation de l'utilisateur.
|
||||
|
||||
## Ce qui n'a pas marché
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
#!/usr/bin/env bash
|
||||
# Compile la présentation d'un dossier support/ (presentation.typ et ses images) avec la fabrique Typst AIMsight,
|
||||
# puis remet le PDF à côté du rapport, en presentation.pdf.
|
||||
# Compile la présentation d'un dossier support/ (<station>.typ et ses images) avec la fabrique Typst AIMsight,
|
||||
# puis remet le PDF à côté du rapport, en <station>.pdf (nom de la station en minuscules).
|
||||
# Usage, depuis la racine du dépôt : bash .claude/skills/presentation/compiler.sh support/<dossier>
|
||||
set -euo pipefail
|
||||
dossier=$(realpath "$1")
|
||||
@@ -9,11 +9,12 @@ racine=$(cd "$(dirname "$0")/../../.." && pwd)
|
||||
# brand/ à la racine du dépôt, lien vers la charte de la fabrique : le source se compile aussi sur place (VS Code, Tinymist)
|
||||
[ -e "$racine/brand" ] || ln -s "$F/brand" "$racine/brand"
|
||||
station=$(basename "$dossier" | cut -d_ -f2) # <date>_<STATION>_rapport-situation
|
||||
slug=$(echo "$station" | tr '[:upper:]' '[:lower:]')-situation
|
||||
nom=$(echo "$station" | tr '[:upper:]' '[:lower:]')
|
||||
slug=$nom-situation
|
||||
mkdir -p "$F/documents/$slug"
|
||||
cp "$dossier/presentation.typ" "$F/documents/$slug/main.typ"
|
||||
cp "$dossier/$nom.typ" "$F/documents/$slug/main.typ"
|
||||
cp "$dossier"/*.png "$F/documents/$slug/"
|
||||
(cd "$F" && python3 brand/tools/build.py "$slug")
|
||||
cp "$F/build/$slug-draft.pdf" "$dossier/presentation.pdf"
|
||||
n=$(pdftotext "$dossier/presentation.pdf" - | grep -c Overflow || true)
|
||||
echo "$dossier/presentation.pdf : $n diapositive(s) qui débordent"
|
||||
cp "$F/build/$slug-draft.pdf" "$dossier/$nom.pdf"
|
||||
n=$(pdftotext "$dossier/$nom.pdf" - | grep -c Overflow || true)
|
||||
echo "$dossier/$nom.pdf : $n diapositive(s) qui débordent"
|
||||
@@ -0,0 +1,80 @@
|
||||
"""Figure de présentation : panneaux caméra (tilt, pan, rotation), température, puis corr_y des cibles.
|
||||
|
||||
Usage : .venv/bin/python .claude/skills/presentation/figure-y.py data/STATION sortie.png DEBUT FIN --cam tilt,pan --temp --cibles A,B
|
||||
[--zone D/F ...] [--ligne T] [--toutes] (--toutes : corr_y de toutes les cibles, pour explorer)
|
||||
"""
|
||||
import argparse
|
||||
import os
|
||||
import sys
|
||||
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "..", "agent-tools"))
|
||||
import matplotlib
|
||||
|
||||
matplotlib.use("Agg")
|
||||
import matplotlib.dates as mdates # noqa: E402
|
||||
import matplotlib.pyplot as plt # noqa: E402
|
||||
|
||||
from donnees import charger, charger_camera, charger_temperature, est_reference, filtrer, instant # noqa: E402
|
||||
|
||||
NOMS = {"tilt": "Tilt de la caméra (°)", "pan": "Pan de la caméra (°)", "rotation": "Rotation de la caméra (°)"}
|
||||
|
||||
|
||||
def coupee(points, trou_h=6):
|
||||
"""[(t, v)] -> listes x, y avec None aux trous de plus de trou_h heures (le trait ne relie pas le trou)."""
|
||||
xs, ys, prec = [], [], None
|
||||
for t, v in points:
|
||||
if prec and (t - prec).total_seconds() > trou_h * 3600:
|
||||
xs.append(prec)
|
||||
ys.append(None)
|
||||
xs.append(t)
|
||||
ys.append(v)
|
||||
prec = t
|
||||
return xs, [float("nan") if v is None else v for v in ys]
|
||||
|
||||
|
||||
a = argparse.ArgumentParser()
|
||||
a.add_argument("dossier")
|
||||
a.add_argument("sortie")
|
||||
a.add_argument("debut", type=instant)
|
||||
a.add_argument("fin", type=instant)
|
||||
a.add_argument("--cam", default="")
|
||||
a.add_argument("--temp", action="store_true")
|
||||
a.add_argument("--cibles", default="")
|
||||
a.add_argument("--toutes", action="store_true")
|
||||
a.add_argument("--zone", action="append", default=[])
|
||||
a.add_argument("--ligne", action="append", default=[])
|
||||
a.add_argument("--hauteur", type=float, default=6.4)
|
||||
o = a.parse_args()
|
||||
|
||||
mes = charger(o.dossier)
|
||||
cibles = [c for c in mes if not est_reference(mes[c])] if o.toutes else [c for c in o.cibles.split(",") if c]
|
||||
panneaux = [c for c in o.cam.split(",") if c] + (["temp"] if o.temp else []) + (["y"] if cibles else [])
|
||||
fig, axes = plt.subplots(len(panneaux), 1, figsize=(12.5, o.hauteur), sharex=True, squeeze=False,
|
||||
gridspec_kw={"height_ratios": [1] * (len(panneaux) - 1) + [2 if cibles else 1]})
|
||||
axes = axes[:, 0]
|
||||
cam = [p for p in charger_camera(o.dossier) if o.debut <= p["t"] <= o.fin]
|
||||
for ax, p in zip(axes, panneaux):
|
||||
if p in NOMS:
|
||||
ax.plot(*coupee([(q["t"], q[p]) for q in cam if q[p] is not None]), color="#444", lw=1.2)
|
||||
ax.set_ylabel(NOMS[p].replace(" (", "\n("), fontsize=10)
|
||||
elif p == "temp":
|
||||
ax.plot(*coupee([(t, v) for t, v in charger_temperature(o.dossier) if o.debut <= t <= o.fin]), color="#c0392b", lw=1.2)
|
||||
ax.set_ylabel("Température de\nla station (°C)", fontsize=10)
|
||||
else:
|
||||
for c in cibles:
|
||||
pts = [(m["t"], m["corr_y"]) for m in filtrer(mes[c], o.debut, o.fin) if m["corr_y"] is not None]
|
||||
ax.plot(*coupee(pts), lw=1.3, label=f"{c} (corr_y)")
|
||||
ax.set_ylabel("Déplacement vertical\ncorr_y (mm)", fontsize=10)
|
||||
ax.legend(fontsize=8 if o.toutes else 10, ncol=4 if o.toutes else len(cibles), loc="best")
|
||||
for z in o.zone:
|
||||
d, f = z.split("/")
|
||||
ax.axvspan(instant(d), instant(f), color="#bbb", alpha=0.45, lw=0)
|
||||
for t in o.ligne:
|
||||
ax.axvline(instant(t), color="#333", ls="--", lw=1)
|
||||
ax.grid(alpha=0.3)
|
||||
axes[-1].set_xlim(o.debut, o.fin)
|
||||
axes[-1].xaxis.set_major_locator(mdates.DayLocator(interval=max(1, (o.fin - o.debut).days // 8)))
|
||||
axes[-1].xaxis.set_major_formatter(mdates.DateFormatter("%d.%m"))
|
||||
fig.tight_layout()
|
||||
fig.savefig(o.sortie, dpi=110)
|
||||
print(o.sortie)
|
||||
@@ -9,6 +9,9 @@
|
||||
lang: "fr",
|
||||
)
|
||||
|
||||
// Le tampon « PROJET <révision> » de la charte devient le nom du projet.
|
||||
#show regex("PROJET.*"): "Sandouville"
|
||||
|
||||
#title-slide(
|
||||
kicker: [Point de situation],
|
||||
title: [BREITHORN],
|
||||
|
||||
Reference in new issue
Block a user