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é
|
||||
|
||||
|
||||
Reference in new issue
Block a user