# Phase 27 — Météo visible, micro-relief du sol, profil de performance Règle de la phase : **aucune valeur ni mécanique météo inventée**. Tout effet visuel ajouté est piloté par une grandeur que `WeatherSystem` calculait déjà, ou par une donnée réelle du projet (orthophoto, heightmap LiDAR). Ce qui aurait demandé une mécanique nouvelle est listé en fin de chantier 1 comme **prérequis manquant**, et n'est pas implémenté. Ordre de travail : chantier 1 (météo visible), chantier 3 (micro-relief), chantier 2 (profilage), conformément à la priorité demandée. --- ## Outillage ajouté (préalable aux trois chantiers) * **`--day=N`** (`src/main.cpp`) : jour de partie de départ. `--hour` seul ne choisissait que l'heure du **jour 0**, qui ne contient **aucune perturbation** : il était impossible de capturer la pluie. Le calendrier est déterministe (seed fixe), donc `--day` + `--hour` + `--time-scale=0` épinglent exactement un état météo. * **`tools/shot_weather.ps1`** : captures épinglées (position, cadrage, jour, heure, horloge gelée, `--lock-input`) avec **journal du jeu à côté de chaque image** — nombre de `[Validation]` et ligne `Visuels meteo` relus pour chaque capture. Une capture dont on ne sait pas quel temps il faisait ne prouve rien. * **`tools/profile_phase27.ps1`** : mesure A/B **entrelacée**, poste témoin, santé machine (voir chantier 2). * **`--no-weather-visuals`**, **`--no-ground-detail`** : témoins **étroits**. Chacun coupe l'ajout de la phase et lui seul (la météo continue de peser sur les besoins et les activités ; le terrain garde son orthophoto). * Bilan de fin de partie : poste `visuels meteo` (CPU) et ligne **`Cadence de boucle (PHASE 27)`** — images / secondes de boucle réelles, sans dépendre du titre de fenêtre (±15 %, leçon de la Phase 18). ### Instants de référence (calendrier déterministe, seed fixe) Trouvés en balayant `synopticAt()` sur 30 jours puis sur un an, **pas** choisis au hasard : | instant | nébulosité | précipitation | usage | |---|---|---|---| | j12 13 h | 0,14 | 0 | grand beau | | j0 13 h | 0,54 (0,61 local) | 0 | mi-couvert | | j8 13 h | 0,95 (0,99 local) | 4,9 mm/h (9,2 local) | pluie franche | | j8 22 h | 0,98 local | 8,6 mm/h local | pluie au crépuscule | | j169 9 h 15 | 0,99 local | 9,2 mm/h local, **neige**, −3 °C | neige de jour | L'écart synoptique/local vient du renforcement orographique et du gradient altitudinal déjà modélisés (section 7 de `WeatherParams`) : la vue de l'alpage est à ~1 480 m sur un versant au vent. --- ## CHANTIER 1 — Rendre la météo visible ### Constat avant Un jour de pluie à 95 % de nébulosité se rendait **exactement** comme un jour de grand beau : ciel bleu vif, soleil franc (captures `build/phase27/avant/`). Au passage, un **commentaire mensonger** dans `sunLightFor()` affirmait depuis la Phase 23 que l'ambiante était « écrasée par les nuages en plein jour » ; le code n'a **jamais** lu la nébulosité. Corrigé. ### Architecture Une seule fonction pure, **`weatherVisualsFor(sky, local, params)`** (`world/Weather.hpp/.cpp`), est la traduction météo → image de tout le jeu. Elle ne calcule **aucune** grandeur météo : elle lit l'état synoptique et l'échantillon **local au joueur** que `main.cpp` calculait déjà une fois par image, et part de `sunLightFor()`. Par ciel clair et sol sec, elle rend `sunLightFor()` **au bit près** (testé). ### Traçabilité : quelle grandeur pilote quel effet | effet visuel | grandeur Weather qui le pilote | coefficient d'affichage (PROVISOIRE, `WeatherParams` §6 ter) | |---|---|---| | soleil direct voilé | `WeatherSample::cloudCover` (local) | **aucun nouveau** : réutilise `cloudAspectDamping` (0,85), qui modélisait déjà « les nuages cachent le soleil » pour l'adret | | ambiante diffuse renforcée, de jour seulement | `cloudCover` × part de jour (`daylight`) | `overcastAmbientGain` = 1,0 | | ciel grisé (désaturé vers sa propre luminance, jour/nuit intact) | `cloudCover` | `overcastSkyDarkening` = 0,80 | | pluie / neige à l'écran : densité et opacité | `precipitationMmPerHour` (local) / `precipitationMaxMmPerHour` | aucun (ratio de deux valeurs existantes) | | neige plutôt que pluie | `snowing` (donc `temperatureC` local vs `snowThresholdC`) | — | | inclinaison des traits | `windVector` (vent **local** : sondage amont, cols, abris) | `rainFallSpeedMps` 6,5 / `snowFallSpeedMps` 1,2 (vitesses terminales usuelles) | | brouillard de distance | `precipitationMmPerHour` (local), `snowing` | `rainExtinctionPerKm` 0,25 × R^`0,63` (1/km), × `snowExtinctionMultiplier` 8 pour la neige | | sol assombri | `wetness` (relecture de la pluie des 6 dernières heures, Phase 23) | `wetGroundDarkening` = 0,35 | | couleur du brouillard | = couleur du ciel ci-dessus | — | **Aucun effet n'existe sans sa grandeur.** C'est vérifié par `testWeatherVisuals()` : ciel clair et sec ⇒ lumière de la Phase 23 au bit près, brouillard nul, pluie nulle, sol non assombri ; et, sur **30 jours de jeu à la minute**, pluie et brouillard à l'écran **exactement** quand la météo calcule une précipitation, jamais sinon (0 écart sur 43 200 minutes). ### Cohérence temporelle (point 4 du cahier des charges) Mesurée, pas supposée : sur 30 jours à la minute, le saut maximal d'une minute à l'autre vaut 0,022 pour la couleur du ciel, 0,004 pour l'intensité de pluie, 6,5·10⁻⁵ /m pour le brouillard (montée d'une averse de neige, lisse). Les effets suivent le calendrier synoptique comme le cycle jour/nuit, sans aléa propre. **Une discontinuité, trouvée par le test et laissée telle quelle** : la bascule **pluie ↔ neige** (j1 6 h 55 à 1 500 m : visibilité de 1,6 km à 13 km en une minute). Elle vient du **modèle** — `snowing` est un booléen au seuil `snowThresholdC` — et non du rendu. La lisser demanderait une phase mixte que Weather ne modélise pas (voir prérequis). Le test isole ces minutes (2 bascules sur 30 jours) et fait échouer **tout autre** saut. ### Rendu * `UniformBufferObject` : quatre `vec4` en fin de bloc (`fog`, `precip`, `fall`, `detail`), **neutres par défaut** — sans appel, l'image est celle de la Phase 26. * Brouillard : extinction de Beer-Lambert `exp(-σ d)`, **même fonction** dans `terrain.frag`, `foliage.frag`, `cube.frag` (sinon les arbres ressortiraient nets du voile). σ = 0 ⇒ couleur rendue inchangée. * Pluie/neige : `precip.vert/.frag`, **un triangle plein écran** sans buffer de sommets, trois couches de traits procéduraux, mélange alpha, sans profondeur. La passe est **sautée entièrement** (aucun bind, aucun draw) quand l'intensité vaut 0. Les traits sont collés à l'écran : ils ne passent pas derrière un tronc — compromis assumé « effet d'écran simple ». * Sol mouillé : `albedo *= 1 − precip.w` dans `terrain.frag`. ### Un effet mort trouvé par le journal des captures Première série « après » : le journal affichait **`ambiante x1.00` sous 99 % de nuages**. Le multiplicateur d'ambiante était écrêté à [0, 1] deux fois (dans `weatherVisualsFor` et dans `Renderer::setSun`) ; or il vaut déjà 1 en plein jour : le gain de ciel couvert ne s'appliquait **jamais**. Le test « monotone » ne pouvait pas le voir (une constante ne décroît pas). Corrigé (borne à 4), et un test exige désormais que l'effet **existe** (> ×1,5 sous ciel couvert). ### Vérification * Tests headless : **3631 / 3631** (3607 + 24 nouveaux, `testWeatherVisuals`). * Captures `build/phase27/planche_meteo.png` (témoin `--no-weather-visuals` à gauche, Phase 27 à droite), 5 instants, **0 `[Validation]`** sur les 20 lancements Debug (avant, après, témoin, v1). * Neutralité du témoin : témoin vs capture d'avant = 0,4 à 2,9 % de pixels à plus de 8 niveaux (herbe animée) — le drapeau rend bien la Phase 26. * Effet proportionné à la donnée : grand beau (nébulosité 0,14) = 3,5 % de pixels changés ; mi-couvert 88 % ; pluie 94 %. * Fausse alerte écartée par la mesure : le ciel « gris clair » de j8 22 h n'est pas un bug — à 22 h fin mai c'est encore le crépuscule ; ciel témoin (48, 56, 84), ciel Phase 27 (51, 51, 52) : même luminance, désaturée. ### Prérequis manquants — NON implémentés, faute de grandeur Weather | effet envisagé | ce qui manque dans Weather | |---|---| | brume par temps sec, brume de vallée dans les cuvettes (la carte de piégeage d'air froid existe) | humidité relative / point de rosée : sans eux, rien ne dit **quand** l'air froid piégé condense | | nuages accrochés au relief, plafond bas | altitude de la **base des nuages** : la nébulosité est une fraction de ciel, pas une hauteur | | transition douce pluie ↔ neige (neige fondue) | une **phase mixte** de précipitation ; `snowing` est un booléen | | sol **blanchi** par la neige | un **manteau neigeux** (accumulation / fonte) ; aujourd'hui une chute de neige mouille le sol (`wetness`) et le fonce, ce qui est ce que dit le modèle | | nuages visibles, soleil voilé localement, éclaircies qui défilent | une nébulosité **spatialisée** (champ 2D advecté par le vent) ; la nébulosité est 0D + un renforcement orographique au point | | éclairs / orage | aucune convection profonde modélisée | --- ## CHANTIER 3 — Micro-relief du sol vu de près ### Approche retenue Texture de détail **procédurale** perturbant la **normale** (le grain réagit au soleil de Weather) et, légèrement, l'albédo — pas de micro-déplacement géométrique (il aurait fallu densifier les tuiles CDLOD proches : bien plus cher et plus risqué pour le LOD). * **Bande de fréquences** : de 0,61 m (= le texel de l'orthophoto, lu sur la texture réellement chargée, `TextureData::metresPerTexel()`) jusqu'à ~5 mm, en 7 octaves de rapport 2,2. Rien au-dessus du texel : le grain ne contredit jamais la photo. * **Amplitude pilotée par des données réelles** : contraste local de l'orthophoto (photo nette contre sa version 2 mipmaps plus floue — éboulis contrasté contre prairie lisse) et pente du relief LiDAR (1 − N.y). Plancher 50 %. **Le motif lui-même est un bruit** et ne représente aucun caillou réel ; c'est dit dans le shader. * **La normale perturbée ne sert qu'à l'éclairage** : l'indice adret/ubac garde la normale du relief (il doit dire la même chose que la météo). * **Deux fondus** : par distance (5 → 20 m) et **par octave selon l'empreinte du pixel** (`fwidth`, Nyquist : plein poids ≥ 4 px, éteint à 2 px) — c'est ce second fondu qui interdit le moiré en vue rasante. Les mipmaps de la texture filtrent en plus le sous-pixel. Lectures en `textureGrad` avec dérivées prises hors branche (boucle à sortie non uniforme). ### Paramètres finaux | paramètre | valeur | où | |---|---|---| | force | 1,0 | `kGroundDetailStrength` (`main.cpp`) | | fondu distance | 5 → 20 m | `kGroundDetailFadeStart/End` | | motif de base | texel de l'ortho (0,610 m), 0,61 par défaut | `groundDetailPattern` | | octaves / lacunarité | 7 / 2,2 | `terrain.frag` | | pente max du grain | 1,3 × amplitude | `kDetailSlope` | | couleur | ±30 % en crête, ±10 % typique | `kDetailAlbedo` = 0,30 | | rugosité pleine | contraste photo 0,12 ou pente 0,35 | `kDetailFullContrast/Slope` | | texture de bruit | 256², 32 cellules, RGBA8 + 9 mips (341 Ko) | `assets/DetailNoise.cpp`, binding 2, adressage REPEAT | ### Vérification `build/phase27/planche_sol.png` (témoin `--no-ground-detail` à gauche). Énergie haute fréquence (laplacien) mesurée sur les captures : | vue | sol proche (moitié basse) | loin (tiers haut) | |---|---|---| | au ras du sol | 5,92 → **7,24 (+22 %)** | — | | vue de marche | — | 3,01 → **3,01 (inchangé)** | Le sol est visiblement grenu sous les pieds, et **rien** n'est ajouté au loin (pas de moiré mesurable sur image fixe). **Limite** : des images fixes ne prouvent pas l'absence de scintillement **en mouvement** ; le fondu de Nyquist le prévient par construction, non vérifié en déplacement. ### Une première version rejetée PAR LA MESURE La v1 calculait le bruit dans le shader. Première mesure de l'effet visuel : énergie HF proche **inchangée** (5,92 → 5,91) — 4 octaves s'arrêtaient à 6 cm, soit 15 pixels à 2 m : de l'ondulation, pas du grain ; et l'amplitude était divisée deux fois (normalisation + moyenne des gradients). Corrigé à 7 octaves. Puis son coût s'est révélé inacceptable → bruit en texture (chantier 2). --- ## CHANTIER 2 — Profilage et optimisation ### Protocole (`tools/profile_phase27.ps1`) * Paires A/B **entrelacées** (AB, BA, AB…), B = témoin **étroit** de l'ajout mesuré (`--no-weather-visuals`, `--no-ground-detail`, ou les deux = Phase 26). * Métrique : `Cadence de boucle` (µs par image réelles) et les postes `Cout par image (PHASE 19)`. * **Santé machine par run** : charge totale échantillonnée pendant le run moins le CPU de vercora. Plus d'un cœur entier ⇒ **NON CONCLUANT**, exclu des médianes ; moins de 20 img/s ⇒ NON CONCLUANT (« n'a pas pu rendre »). * Machine : i5-14600K, UHD 770 intégré, 1280×720. **Deux défauts de l'outil trouvés en l'écrivant** : la 1re version du témoin de santé sommait `TotalProcessorTime` sur une liste de processus qui change pendant le run (« 318 910 % d'un cœur ») — remplacée par un échantillonnage de charge ; et le bureau au repos (application Claude, webviews, Discord) consomme 25 à 130 % d'un cœur, d'où un seuil à 1 cœur, justifié dans le script. Beaucoup de runs ont été écartés à ce titre : les tableaux ci-dessous n'utilisent que les runs sains, et le signalent quand il n'en restait pas. ### Leçon de méthode : un poste CPU n'est pas un témoin sur GPU intégré Sous la pluie, l'herbe (CPU) a été **systématiquement** plus lente en A qu'en B (495 contre 374 µs, +32 %), tour après tour, **dans les deux ordres** — donc pas une dérive de la machine. Par beau temps, où A et B chargent le GPU pareil : écart 4 %. Sur un GPU **intégré**, CPU et GPU partagent le budget de puissance du boîtier ; charger le GPU ralentit le CPU. Le témoin CPU est donc **couplé** à toute modification GPU et ne peut pas la valider. Il reste valide quand la condition ne change pas la charge GPU (beau temps : 4 % ; vue de marche finale : 2 %). ### Profil actuel (tout le contenu depuis la Phase 19), médianes | config / vue | total | drawFrame | herbe | arbres | fibres | streaming | |---|---:|---:|---:|---:|---:|---:| | Release, vue fixe alpage, beau | 4 962 µs | 4 228 (**85 %**) | 408 | 253 | 17 | 14 | | Release, survol 900 m/s (Phase 26) | 1 495 µs | 1 126 (75 %) | 1 | 241 | 10 | 82 | | Debug, vue fixe alpage, beau | 7 838 µs | 2 099 (27 %) | **3 482 (44 %)** | 1 775 | 191 | 95 | | Debug, survol 900 m/s (Phase 26) | 4 429 µs | 1 236 (28 %) | 9 | 1 987 | 124 | 939 | * **Release est limité par le GPU** (75–85 % dans `drawFrame`) : optimiser les postes CPU (herbe 0,4 ms, arbres 0,25 ms) ne rendrait **rien**, conformément à la Phase 19. **Aucune optimisation CPU n'a donc été faite.** * **Debug est limité par le CPU** (herbe 44 %) : le même changement GPU y est invisible — la pluie y coûte −83 µs (bruit). Mesurer en Debug seul aurait conclu « gratuit ». La leçon de la Phase 19 se vérifie encore. * Les chiffres de survol ne sont pas comparables tels quels à ceux de l'audit (378 img/s) : l'audit ne précisait ni jour, ni heure, ni drapeaux ; ici le survol est épinglé à j8/j12 13 h. ### Coût des ajouts de la Phase 27 (Release, A − B) | mesure | coût | statut | |---|---:|---| | beau temps, vue fixe (contrôle négatif météo) | −28 µs (0) | gratuit par temps sec | | survol beau temps (shaders modifiés, rien d'actif) | +54 µs (+3,6 %) | surcoût fixe des shaders | | **pluie, vue fixe** (passe plein écran + brouillard + sol mouillé) | **+608 µs (+12 %)** | **accepté** : seulement quand il pleut, ~180 img/s | | survol sous la pluie | +684 µs | idem (≈ passe de pluie) | | micro-relief v1, au ras du sol | **+1 683 µs (×1,94)** | **rejeté** | | v1 + Nyquist resserré à 8 px | +1 490 µs | insuffisant | | v1 sans aucune octave (bissection) | +330 µs | ⇒ ~200 µs **par octave** | | v1 à 2 octaves (bissection) | +720 µs | confirme : ALU, pas un surcoût fixe | | v1 avec hash flottant au lieu d'entier | ≈ inchangé | hypothèse réfutée | | **v3 : bruit en texture**, au ras du sol | **≈ +900 µs** | −47 % | | v3 sans la lecture floue d'ortho (bissection) | ≈ inchangé | lecture gratuite, conservée | | v3, **vue de marche**, fondu 35 m | +623 µs (+15 %) | | | **v3, vue de marche, fondu 20 m (final)** | **+480 µs (+11 %)** | **retenu**, témoin stable (2 %) | (Les valeurs « ≈ » viennent de runs dont les A ont tous dépassé de peu le seuil de santé, sans médiane formelle ; leur dispersion était de ±0,2 %.) Seule optimisation livrée : **le micro-relief**, le seul poste nouveau mesuré comme significatif — de +1 683 à ~+900 µs dans le pire cas, et +480 µs en vue de marche. Trois hypothèses ont été **réfutées par la mesure** avant de trouver la bonne (octaves fines, hash entier, lecture floue) ; aucune n'a été gardée « au cas où ». **Non fait, et pourquoi** : la passe de pluie (+608 µs) n'est active que pendant les précipitations (~9 % du temps sur 30 jours de jeu) et le jeu y reste vers 180 img/s ; l'alléger (moins de couches, demi-résolution) dégraderait la lisibilité, qui est l'objectif du chantier 1. À reprendre si une cible plus faible que l'UHD 770 est visée. --- ## Vérification globale * Tests headless : **3636 / 3636** (3607 + 29 : `testWeatherVisuals`, `testDetailNoise`). * 0 `[Validation]` sur toutes les captures Debug de la phase et sur les runs Debug de profilage. * Suite `run_vulkan_check.ps1` (build Debug final, couches de validation) : **verte au premier passage** — scénarios A à J3 (14 processus : gameplay, collision, dalle LiDAR, parapente, vélo, escalade « sommet atteint : True », éditeur G1-G3, besoins, faune, récolte et fibres), **Messages [Validation] : 0**, fermeture propre. Un seul passage : la flakiness historique du harnais (D2 de l'audit) n'a donc pas été re-mesurée ici. ## Où je me suis arrêté Les trois chantiers sont livrés. Restent ouverts, sciemment : * scintillement du micro-relief **en mouvement** : non vérifié (images fixes seulement) ; * passe de pluie à +608 µs : non optimisée (voir chantier 2) ; * effets météo qui demanderaient une mécanique absente de Weather : listés dans « Prérequis manquants », non implémentés, par règle.