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:
maximeandClaude Opus 5.5 committed 2026-11-03 17:36:25 +01:00
1 parent efbc5f15d7
commit 85e590762b
19 files changed
+6163 -6148

No files matched your search

+19 -9
View File
@@ -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é