Premier commit

Cette révision appartient à :
Théo Gastinel a révisé 2026-10-11 01:54:18 +02:00
révision 84a72fe30c
200 fichiers modifiés
+61602

Aucun fichier ne correspond à votre recherche

+701
Voir le fichier
@@ -0,0 +1,701 @@
# NOTES-PHASE23.md — Systeme meteo deterministe
Session du 2026-08-27. Suite de la Phase 22.
---
## 0. Avertissement, a lire avant tout le reste
**Aucune des valeurs numeriques de ce systeme n'a ete validee par un
climatologue.** Ce sont des ordres de grandeur plausibles, choisis pour que le
systeme produise un comportement lisible en jeu.
Le code separe donc strictement deux choses :
- **L'architecture et les mecanismes** — implementes serieusement, testes, et
independants des chiffres. Comment un gradient altitudinal, un sondage amont,
une inversion de fond de cuvette ou un renforcement orographique se calculent
ne changera pas apres relecture scientifique.
- **Les valeurs numeriques** — toutes regroupees dans **une seule struct**,
`WeatherParams` (`src/world/Weather.hpp`), chacune commentee avec ce qu'elle
fait, sa valeur provisoire et d'ou elle sort. Les recalibrer se fait en
ouvrant un seul fichier et en changant des nombres, sans toucher a une ligne
de logique.
Deux exceptions, qui ne sont **pas** provisoires et sont sourcables :
| Grandeur | Source |
|---|---|
| Refroidissement eolien | Formule JAG/TI, employee par Environnement Canada et le NWS depuis 2001 |
| Declinaison solaire | Formule de Cooper (1969) |
Une troisieme est un fait et non un reglage : la latitude, 45,0 degres, parce
que la dalle LiDAR chargee est en Isere (Le Gua).
Les tests headless verifient en consequence des **proprietes** ("un adret est
plus chaud qu'un ubac au meme instant", "un col vente plus qu'un plateau
adjacent") et **jamais des valeurs absolues**. Un test qui exigerait
"l'inversion vaut -6 degres" devrait etre reecrit le jour du recalibrage et ne
dirait rien de plus que "la constante vaut ce qu'elle vaut".
### Ce qui demande une vraie validation climatique externe
Par ordre decroissant de doute :
1. **`precipitationCloudThreshold` (0,72)** — c'est ce seuil qui fixe la
frequence des precipitations, et il est le plus arbitraire du fichier. Il
donne aujourd'hui 61 heures de pluie et 63 heures de grand beau sur trente
jours de jeu simules, ce qui *semble* raisonnable pour un printemps de
moyenne montagne, mais rien ne l'appuie.
2. **`frontNoiseGain` (2,2)** — ce parametre n'existe que pour une raison
technique (voir §4), mais il pilote de fait l'amplitude de tout le
calendrier meteo. Il faut le recalibrer avec le seuil ci-dessus, pas
separement.
3. **`frontPeriodDays` (3,5)** — la duree d'un cycle de degradation.
4. **`inversionMaxC` (-6)** et **`inversionMixingWindMps` (4)** — le signe et
l'ordre de grandeur sont surs, le chiffre exact non. Une inversion reelle en
moyenne montagne va de 5 a 10 degres.
5. **`exposureWindGain` (0,80)** et **`venturiWindGain` (0,70)** — l'ordre de
grandeur de l'acceleration au-dessus d'une crete (1,5 a 2) est documente ;
la valeur pour un col ne l'est pas, et elle depend enormement de la geometrie
du col, que le modele ne mesure que grossierement.
6. **`lapseRateCPerKm` (6,5)** — la moins douteuse (c'est le gradient
adiabatique standard), mais un gradient reel varie de 4 (air humide) a 9,8
(air sec) et le modele n'en tient pas compte.
7. **Toutes les distances de sondage** (250 / 750 / 2000 / 100 / 400 m) — elles
viennent de la recherche preparatoire, elles n'ont ete verifiees par rien.
---
## 1. Ce qui a ete fait
Les quatre priorites du cahier des charges sont faites, dans l'ordre demande.
| # | Priorite | Etat |
|---|---|---|
| 1 | Module synoptique + temperature locale, remplacant celle de Needs | **fait** |
| 2 | Cycle jour/nuit visuel | **fait** |
| 3 | Vent / sondage amont | **fait** |
| 4 | Effets sur les quatre activites | **fait** |
Fichiers neufs : `src/world/Weather.hpp` (≈ 700 lignes, dont la majorite est de
la documentation de constantes) et `src/world/Weather.cpp`.
---
## 2. Architecture
### Une fonction d'etat pure
Le module n'a **aucun etat cache** et **aucune integration dependante du pas de
temps**. Pour un point `(x, y, z)` et un instant `t`, `sampleAt()` rend l'etat
meteo exact.
Consequence de jeu : deux joueurs qui arrivent au meme endroit au meme instant
vivent exactement les memes conditions, quel que soit le chemin parcouru, la
duree du trajet, le nombre d'images par seconde ou le nombre de pauses.
Consequence de test : un test peut sauter directement a `t = 137 h` sans simuler
les 137 heures. C'est ce qui rend la couverture de cette phase possible.
Contraste explicite avec `Needs` (Phase 16), qui **integre** dans le temps :
les quatre jauges ont une memoire, c'est leur role. Rien n'a change de ce
cote — sauf d'ou vient la temperature ambiante.
### Deux couches
**Couche 1, synoptique (0D)** — `WeatherSystem::synopticAt(gameHours)` →
`SynopticState`. L'etat macro du massif : saison (deux harmoniques), cycle
diurne (deux harmoniques, attenuees par les nuages), perturbations (bruit de
gradient 1D en fonction du temps), position solaire, vent de reference,
nebulosite, precipitation. Ne connait **aucune position**.
**Couche 2, spatialisation (3D)** — `WeatherSystem::sampleAt(position, sky,
terrain)` → `WeatherSample`. La reponse du terrain a cet etat macro : gradient
altitudinal, adret/ubac par produit scalaire, inversion de fond de cuvette, vent
local par sondage amont, ridge lift, subsidence et turbulence de sillage,
thermiques, renforcement orographique, mouillure du sol.
La surcharge `sampleAt(position, SynopticState, terrain)` existe pour
echantillonner plusieurs points au meme instant sans recalculer la couche 1 —
elle est 10 fois moins chere que la couche 2 (mesure : 0,38 µs contre 4,0 µs).
### Le seed
**Fixe par defaut** (`WeatherSystem::kDefaultSeed`), et derivable d'une graine de
partie par le constructeur. Le choix du seed fixe est delibere :
- La zone de jeu est unique et fabriquee a la main (une dalle LiDAR reelle),
pas generee par partie. Rien d'autre dans Vercora n'est reseede par partie :
le semis de vegetation et celui de la faune sont deterministes a graine fixe
depuis la Phase 11.
- Un seed fixe rend une capture d'ecran comparable a la precedente, ce qui est
la condition meme de la verification visuelle du projet (lecon de la Phase 12
sur `--look`).
- Le jour ou les parties multiples existeront, passer la graine au constructeur
suffit, sans rien changer d'autre.
---
## 3. Une seule source de verite sur la temperature
C'etait la contrainte la plus explicite du cahier des charges, et elle a
demande de **deplacer du code plutot que d'en ajouter**.
### Ce qui a quitte `Needs`
| Parti de `Needs` | Arrive dans `Weather` |
|---|---|
| `NeedsParams::seaLevelMeanTemperatureC` | `WeatherParams::seaLevelAnnualMeanC` (+ saison explicite) |
| `NeedsParams::lapseRateCPerKm` | `WeatherParams::lapseRateCPerKm` |
| `NeedsParams::diurnalAmplitudeC` | `WeatherParams::diurnalAmplitudeC` |
| `NeedsParams::diurnalPeakHour` | `WeatherParams::diurnalPeakHour` |
| `NeedsParams::exposureBonusC` | `WeatherParams::aspectBonusC` |
| `NeedsParams::paraglideWindChillC` | **supprime**, remplace par `windChillC()` (JAG/TI) |
| `ambientTemperature()` | `WeatherSystem::sampleAt().temperatureC` |
| `daylightFactor()` | `SynopticState::daylight` (vraie position solaire) |
| `terrainExposure()`, `kFullExposureSlope` | inchanges, simplement demenages |
`NeedsContext` porte desormais `ambientTemperatureC` et `windSpeedMps` a la
place de `altitudeMeters` / `timeOfDayHours` / `exposure`. **Needs ne calcule
plus aucune temperature ambiante** — il en recoit une et n'y ajoute que ce qui
concerne le corps du joueur : effort, fatigue, abri, vent subi.
Ce n'est pas de la cosmetique. Tant que les deux calculs coexistaient, rien
n'empechait qu'un reglage n'en corrige qu'un.
### Ce qui n'est pas un simple renommage
`ambientTemperature()` de la Phase 16 ne connaissait que l'altitude, l'heure et
une exposition nord/sud. Sa remplacante connait en plus la **saison**, la **masse
d'air** (perturbation en cours), la **nebulosite** (qui ecrase l'amplitude
diurne — c'est ce qui fait qu'une nuit couverte est douce et une nuit claire
glaciale) et l'**inversion de fond de cuvette**.
`daylightFactor()` etait une demi-sinusoide fixe de 6 h a 18 h. Sa remplacante
est le sinus de l'elevation solaire reelle, calculee depuis la latitude et la
declinaison du jour : les journees s'allongent et se raccourcissent avec la
saison.
### L'adret/ubac calcule par produit scalaire
Le cahier des charges demandait un produit scalaire entre la normale du terrain
et la direction du soleil. C'est ce qui est fait, mais avec une precision qui
compte : on compare le cosinus d'incidence du point a **celui qu'aurait du
terrain plat au meme instant**, et on convertit l'ecart en degres via
`aspectIncidenceReference`.
Le comportement qui en decoule est meilleur que celui de la Phase 16, et il
sort tout seul de la geometrie :
- **A midi**, un versant sud ne gagne presque rien (il est deja a peu pres
perpendiculaire au rayonnement) alors qu'un versant nord perd beaucoup.
- **Au petit matin**, c'est un versant **est** qui recoit le maximum — un modele
purement nord/sud ne pouvait pas le produire, et c'est verifie par un test.
Mesure a midi, 1000 m, sur pente de 60 % : adret 14,7 °C, ubac 10,7 °C, soit
4,0 °C d'ecart.
---
## 4. Ce que les tests ont corrige
Quatre choses ont ete **fausses puis corrigees parce qu'un test les a montrees**.
Elles sont notees ici parce que ce sont les seules parties du travail dont on
sait qu'elles ne sont pas seulement plausibles.
### (a) Le bruit n'atteignait jamais ses extremes
Un fBm de bruit de gradient n'atteint pas ses bornes theoriques. Sans gain, la
nebulosite mesuree sur trente jours restait entre 0,20 et 0,70 : **jamais de
grand beau** (donc jamais de nuit claire, donc jamais d'inversion) et presque
jamais de vraie pluie — 13 heures sur 720.
Corrige par `frontNoiseGain` (2,2) suivi d'un ecretage. Le test qui l'a montre
demande qu'un mois de jeu contienne des journees claires **et** des journees de
pluie ; c'est le controle negatif d'un modele qui aurait l'air de fonctionner
tout en etant constant. Apres correction : 61 h de pluie, 63 h de grand beau.
### (b) Un versant sud plus chaud a deux heures du matin
L'ecart d'incidence continuait de se calculer avec un soleil **sous l'horizon**,
ou il n'a aucun sens. Resultat mesure : +2,9 °C pour un adret a 2 h du matin.
Corrige par `aspectFullDaylightSin` (0,25), qui eteint l'effet quand le soleil
est bas — ce qui est aussi le comportement reel, un rayonnement rasant chauffe
peu quelle que soit l'orientation. Le test est un controle negatif : la nuit,
adret et ubac doivent etre a moins de 0,001 °C l'un de l'autre.
### (c) La moyenne des sondages amont effacait l'abri
La premiere version faisait une moyenne ponderee des trois altitudes amont. Un
point situe 250 m sous le vent d'une crete de 200 m — un abri franc — obtenait
un signal d'exposition de **-0,05** : la crete etait bien vue par la sonde
proche, mais la plaine des sondes a 750 m et 2000 m ramenait la moyenne au
niveau du point, et l'abri disparaissait dans l'arithmetique.
La regle correcte tient en une phrase : **etre abrite, c'est avoir du relief
au-dessus de soi dans au moins une des echelles amont ; etre expose, c'est
dominer toutes les echelles a la fois.** D'ou un `max` d'un cote et un `min` de
l'autre, jamais une moyenne.
### (d) La turbulence de sillage se mesurait sur le mauvais vent
Elle etait calculee a partir du vent **local**, qui est justement faible sous le
vent (c'est ce que le facteur d'abri vient de calculer). Un sillage etait donc
d'autant plus calme qu'il etait plus abrite — l'inverse exact de la realite. Ce
qui agite l'air d'un sillage est le flux qui vient de decoller de la crete,
lequel a la vitesse **amont**. Corrige : la turbulence et la subsidence se
mesurent sur le vent de reference.
### Et une correction cote test, pas cote code
Le test d'inversion employait d'abord une cuvette de 400 m de profondeur pour
500 m de rayon. Il echouait — mais pas parce que le modele avait tort : a 400 m
de denivele, le seul gradient adiabatique rend le fond 2,6 °C **plus chaud** que
le rebord, et l'inversion, correctement calculee, ne suffisait pas tout a fait a
renverser ce handicap. Le relief etait invraisemblable : une cuvette de 400 m de
creux pour 500 m de rayon est une falaise circulaire, pas une combe. Ramene a
150 m, le test passe largement.
C'est la troisieme fois dans ce projet que l'hypothese "le test a tort" se
verifie (voir MEMORY.md). Elle merite d'etre instruite aussi serieusement que
l'inverse — et aussi serieusement rejetee quand elle est fausse, ce qui a ete le
cas pour les quatre defauts ci-dessus.
---
## 5. Le sondage amont
C'est la technique centrale de la couche 2. Au lieu de simuler l'ecoulement, on
**demande au relief ce qu'il fait au vent**, en lisant la heightmap a quelques
distances autour du point.
**Sept appels a `heightAt()` par evaluation** : le point, trois en amont (250 /
750 / 2000 m), un en aval (100 m), deux lateraux (± 400 m perpendiculairement au
flux). C'est le budget d'une seule lecture de pente du velo.
Ce qui en est tire :
- **Exposition / abri** — `min`/`max` sur les trois echelles amont (voir §4c).
Un point qui domine tout son amont vente jusqu'a 1,8 fois le vent libre ; un
point abrite n'en garde que 25 %.
- **Venturi** — les deux sondes laterales. Si les deux epaules dominent le
point, le flux passe par un entonnoir et accelere.
**Une ponderation existe et elle n'est pas cosmetique** : un fond de vallee a
lui aussi ses deux cotes plus hauts, exactement comme un col. La seule chose
qui les distingue est le rapport a l'amont — un col domine son amont (le vent
le franchit), un fond de vallee non (le vent passe au-dessus). Sans ce poids,
chaque fond de vallee de la zone de jeu deviendrait une soufflerie.
- **Ridge lift** — la pente dans le sens du flux, sur l'echelle proche. L'air
qui monte une pente `s` a la vitesse `U` monte a `s·U`, moins un rendement.
- **Subsidence et turbulence de sillage** — pilotees par l'abri et par le vent
amont.
- **Renforcement orographique** — la meme pente dans le sens du flux : un
versant que le flux doit gravir souleve la masse d'air, donc il pleut plus.
Mesures sur le relief de test (crete nord-sud de 400 m avec un col, vent
d'ouest) :
| Point | Vent | Facteur de relief |
|---|---|---|
| Col | 14,2 m/s | × 2,01 |
| Crete pleine | — | × 1,80 |
| Plateau au vent | 6,4 m/s | × 1,00 |
| Versant au vent | ridge lift **+4,99 m/s**, turbulence 0,00 | |
| Versant sous le vent | subsidence **-1,80 m/s**, turbulence 0,60 | |
Le col vente 2,2 fois plus que le plateau adjacent, et **plus que la crete
pleine a vent de reference egal** — c'est-a-dire que l'effet d'entonnoir est
bien distingue de l'effet d'altitude.
---
## 6. La carte de piegeage d'air froid
Precalculee **une fois au chargement**, jamais par image — c'est l'exigence de
cout du cahier des charges.
**Ce qu'elle mesure** : a quel point un point est un *creux enferme*. Autour de
chaque cellule on sonde huit directions a trois rayons (120 / 350 / 900 m), et
on regarde combien de ces 24 sondes sont plus hautes que la cellule, et de
combien.
**Pourquoi pas simplement "l'altitude est basse"** : un versant a mi-hauteur et
un fond de vallee peuvent etre a la meme altitude, et seul le second piege l'air
froid. C'est l'**enfermement** qui compte, pas l'altitude — la meme lecon que la
Phase 22 sur le relief (savoir ou il y a de la pente ne dit pas par ou
l'aborder).
Resolution **128 × 128 sur les 5 km** de la zone de jeu, soit des cellules de
39 m : la bonne echelle pour une cuvette (une cuvette de 39 m n'en est pas une).
Cout : 393 216 lectures de heightmap, payees une seule fois au chargement.
Lecture au runtime : une interpolation bilineaire.
Le controle negatif est celui qu'employait deja la Phase 16 pour les points
d'eau : une **bosse** de geometrie identique doit obtenir un index quasi nul.
Mesure : creux 0,65, plateau 0,00, bosse 0,00.
L'inversion elle-meme exige **trois conditions simultanees**, et le produit des
trois les exprime directement : un creux ferme, la nuit, un ciel clair et calme.
Le test verifie qu'elle **renverse le signe du gradient** — le fond, pourtant
150 m plus bas, doit etre plus froid que le plateau. Mesure : fond 2,1 °C,
plateau 3,6 °C.
Sans carte reliee (aucun terrain charge), l'inversion vaut zero partout et le
reste du systeme fonctionne. C'est un repli explicite, teste, pas une panne.
---
## 7. Le cycle jour/nuit visuel
**C'est la correction de l'incoherence assumee en Phase 16.** Le commentaire de
`GameClock` disait : *"cette horloge n'existe QUE pour la temperature, et rien
dans le rendu ne change avec elle"*. Ce n'est plus vrai.
La lumiere directionnelle existante (Blinn-Phong, Phase 2) est desormais
alimentee par la **meme position solaire** que l'adret/ubac et les thermiques.
Il n'y a donc toujours qu'**un seul soleil** dans le jeu — c'est la meme
exigence que pour la temperature, appliquee a la lumiere, et un test la verifie
explicitement (`dot(light.direction, sky.sunDirection) == 1`).
Chemin : `SynopticState` → `sunLightFor()` → `Renderer::setSun()` →
`UniformBufferObject::sun` / `sunColor` → les trois shaders de fragment.
Ce qui a change dans les shaders : `kLightDirection` et `kLightColor`, qui
etaient des constantes en dur dans `cube.frag`, `foliage.frag` et
`terrain.frag`, viennent de l'UBO.
**Deux details qui evitent des regressions :**
- `sunColor.a` est un **multiplicateur** de l'ambiante, pas une valeur absolue.
Les trois shaders ont des ambiantes differentes et justifiees (0,15 pour le
cube, 0,18 pour le terrain, 0,24 pour le feuillage, qui laisse passer la
lumiere). Les remplacer par une valeur unique aurait ete une regression de
rendu deguisee en correction de cycle.
- Les valeurs **par defaut** de l'UBO et de `Renderer` reproduisent exactement
l'ancien eclairage. Un rendu qui n'appellerait pas `setSun()` est pixel pour
pixel celui de la Phase 22.
**Le ciel suit aussi, et il a fallu une capture pour s'en apercevoir.** La
premiere version ne touchait qu'a la lumiere. Le relief s'assombrissait
correctement, mais la couleur d'effacement restait le bleu vif de midi : la
capture de 3 h du matin montrait la silhouette *noire* des sapins sur un ciel de
plein jour. La lumiere etait juste, l'image ne l'etait pas.
`SunLight` porte donc aussi une `skyColor`, avec sa propre palette (jour /
crepuscule / nuit) parce que le ciel n'est pas eclaire par le modele
d'eclairage — c'est un fond. Le crepuscule occupe la premiere moitie de la montee
du soleil, ce qui fait durer l'aube et le coucher au lieu d'un fondu direct du
noir au bleu.
**C'est le seul defaut de cette phase qu'aucun test headless ne pouvait
trouver** : il n'existait que dans l'image.
Quand le soleil passe sous l'horizon, la direction **bascule a la verticale** :
une lumiere directionnelle venue d'en dessous eclairerait le relief par le bas,
qui est le defaut visuel classique d'un cycle jour/nuit bacle. Un test verifie
`direction.y >= 0` a toutes les heures.
**`nightAmbientFactor = 0,30` est un choix de jouabilite assume, pas une
mesure.** Une vraie nuit sans lune est noire ; un jeu d'exploration ou l'on ne
voit rien pendant la moitie du temps de jeu n'est pas jouable en l'etat, aucune
source de lumiere portable n'existant encore. A revoir le jour ou le feu de camp
arrivera.
L'aube et le crepuscule durent : 20 intervalles de 5 minutes en lumiere
partielle sur 24 heures.
---
## 8. Les effets sur les quatre activites
Tous branches sur les systemes existants. **Aucun nouveau systeme parallele.**
Chaque nouveau parametre a une valeur par defaut neutre, et un test de
non-regression verifie que l'omettre reproduit **exactement** — comparaison
bit a bit sur les positions — le comportement d'avant la Phase 23.
### Needs (temperature) — priorite 1
Voir §3. Le refroidissement eolien remplace le forfait de -6 °C que la Phase 16
reservait au vol : c'est desormais la formule JAG/TI appliquee au vent reel,
auquel l'appelant ajoute la vitesse propre du joueur (vitesse de l'aile en vol,
vitesse du velo a velo). La **marche en crete par vent fort** refroidit donc
elle aussi, ce qu'un forfait reserve au vol ne pouvait pas exprimer.
Hors du domaine de validite publie (T > 10 °C ou vent < 4,8 km/h), la fonction
rend la temperature **inchangee** plutot qu'une extrapolation : au-dessus de
10 °C la formule brute rendrait un vent *rechauffant*. C'est le point le plus
facile a rater dans une implementation pressee, et un test le couvre.
Un abri annule le refroidissement eolien — c'est la definition d'un abri.
### Paraglider — priorite 4
Nouvelle struct `AirState` (vent, vitesse verticale, turbulence), volontairement
**nue** et non un `WeatherSample` : `Paraglider` ne doit pas plus dependre du
systeme meteo qu'il ne depend de Vulkan. Meme separation que `HeightSampler`.
- **Derive** — `speed_` est une vitesse **air** ; la vitesse sol est cette
vitesse plus le vent. C'est l'ajout le plus lisible en jeu, et il ne demande
aucune regle particuliere. Mesure sur 30 s avec 6 m/s de vent : 495 m vent
arriere, 315 m en air calme, 135 m vent de face.
- **Ascendances** — le taux de chute de l'aile plus le mouvement de l'air. Dans
une thermique plus forte que le taux de chute, la somme est positive et l'aile
**monte** : la definition du vol thermique sort de l'addition. Mesure sur
30 s : 1462 m en air calme, 1553 m dans 3 m/s d'ascendance.
- **Turbulence** — deux sinusoides de periodes **incommensurables**, pas un
tirage aleatoire. Le vol reste deterministe (donc rejouable et testable, la
regle de toute la phase), et deux periodes sans rapport simple ne se
resynchronisent jamais, donc le chahut ne degenere pas en balancement
regulier — ce qui est ce qui trahit immediatement une turbulence fabriquee.
Le modele ne represente **ni fermeture ni decrochage** : une aile chahutee
perd du cap et de la finesse, elle ne tombe pas.
### Climber — priorite 4
`update()` prend une **adherence** dans `[0, 1]`, tiree de l'humidite locale par
`Climber::gripForWetness()` — expose comme methode de la classe pour qu'il n'y
ait qu'une seule traduction humidite → adherence dans le jeu.
L'effet porte sur la physique existante et il est **double**, ce qui compte :
- la **vitesse** de progression (ascension et traversee) est multipliee par
l'adherence ;
- le **cout energetique par metre** monte jusqu'a × 1,8.
Le second terme n'est pas un bonus : sans lui, un modele qui ne ferait que
ralentir laisserait la jauge dire le contraire — moins de metres parcourus, donc
moins d'energie depensee, donc une paroi mouillee *moins* fatigante. Mesure sur
20 s : sec 19,3 m a 0,018 de jauge/m, mouille 8,9 m a **0,032** de jauge/m.
Un plancher d'adherence a 0,05 garantit qu'une paroi ruisselante reste
**grimpable**, tres lentement et tres chere, plutot que de devenir une impasse
ou le joueur resterait bloque sans pouvoir ni monter ni redescendre.
### Bike — priorite 4
Fait, dans une version deliberement minimale : une seule grandeur (l'humidite du
sol) et deux coefficients, branches sur des termes qui existent deja dans
l'equation du mouvement, **sans ajouter le moindre etat**.
- resistance au roulement + 45 % sur sol detrempe ;
- freinage - 30 %.
Mesures : vitesse d'equilibre a plat 16,9 km/h sur sec contre 15,9 km/h sur
trempe ; une demi-seconde de frein enleve 11,7 km/h sur sec contre 8,8 km/h sur
trempe.
**Ce qu'il ne fait pas**, et c'est note comme amelioration future : aucune nature
de sol (terre, roche, herbe — le LiDAR n'en porte aucune, limite deja etablie en
Phase 22 pour les gisements), aucune boue qui se formerait et secherait par
endroits, et **aucune perte d'adherence en virage** — le terme lateral n'est pas
touche, parce que le rayon de braquage est un equilibre deja verifie par les
tests de la Phase 13 et qu'y toucher sans mesure serait un pari.
---
## 9. La mouillure du sol : relue, pas accumulee
Le seul endroit ou le systeme pourrait sembler avoir une memoire. Il n'en a pas :
`groundWetness()` **remonte le temps dans la fonction synoptique** — qui est
pure — au lieu d'accumuler image par image.
Huit echantillons sur les six dernieres heures de jeu, chacun decru
exponentiellement, et on garde le plus mouille. C'est le seul endroit ou
l'evaluation meteo depasse la dizaine d'operations, d'ou les huit echantillons
et pas cinquante.
La propriete que ca garantit est testee : un joueur qui arrive au meme endroit au
meme instant trouve la meme mouillure, qu'il ait mis dix minutes ou deux heures
a venir.
---
## 10. Cout
Mesure sur cette machine (i5-14600K, Debug, terrain analytique) :
| | Cout |
|---|---|
| Evaluation complete (couche 1 + couche 2, 7 sondages, mouillure) | **4,0 µs** |
| Couche synoptique seule | **0,38 µs** |
| Carte de piegeage, 128 × 128 | 393 216 `heightAt()`, **une fois au chargement** |
Le jeu fait **une** evaluation complete par image, au point du joueur. A 60 FPS
cela represente 0,024 % d'une image de 16,7 ms.
Le repere de la Phase 19 est que le frame est **domine par le GPU** — 81 % dans
`drawFrame` en Release, et aucune optimisation CPU ne rend rien. La meteo ne
change pas ce constat et n'avait aucune chance de le faire.
Le test de cout porte un seuil **tres large** (50 µs) et volontairement : il
protege contre un facteur mille — un sondage qui deviendrait une recherche, une
carte recalculee par image — et non contre une variation de 20 %, que le bruit de
mesure de cette machine ne permet de toute facon pas de distinguer (lecon de la
Phase 17 sur les FPS bruites).
---
## 11. Verification
### Tests headless
`tools\run_logic_tests.bat` — **3578 assertions**, toutes passantes. Deux
sections neuves :
- `testWeather()` — determinisme (purete bit a bit, independance du chemin via
deux horloges a pas differents, et le controle negatif qu'un temps constant
echouerait), cycles et position solaire, saison, variete des perturbations sur
30 jours simules, gradient altitudinal, adret/ubac (dont le controle negatif
de nuit et le versant est du matin), carte de piegeage et inversion (dont le
controle negatif de la bosse et celui du plein jour), sondage amont (col
contre plateau, col contre crete pleine a vent de reference egal, versant au
vent contre versant sous le vent, controle negatif en air calme, ecretage sur
15 jours), thermiques (dont ciel couvert et ubac), precipitations
orographiques, mouillure, refroidissement eolien (dont les deux bords du
domaine de validite), robustesse aux NaN/inf, et cout.
- `testWeatherGameplay()` — les quatre activites et la lumiere, systematiquement
par comparaison de deux simulations identiques a un parametre pres, chacune
avec son controle negatif de non-regression.
### Vulkan reel
`tools\run_vulkan_check.ps1`, **cinq executions completes** de la suite (dix
scenarios, quatorze processus) sur cette phase.
**Le critere dur est tenu dans les cinq :**
| | Resultat |
|---|---|
| Messages `[Validation]` | **0**, dans les cinq executions |
| Lignes `[ERROR]` | **0**, dans les cinq executions |
| Lignes `[WARN]` | 4, les memes qu'avant la phase |
**Chaque scenario a passe ses assertions de gameplay** sur le binaire final :
terrain synthetique, dalle LiDAR reelle, vol en parapente, sortie a velo
(50,0 km/h au pic en descente, 67 releves), escalade (sommet atteint, 41,8 m
gagnes), editeur en trois processus avec son temoin, besoins primaires (236 et
240 releves sur deux executions isolees apres la correction du 12), empreinte
environnementale, recolte de matieres.
**Aucune execution n'a ete verte de bout en bout, et il faut dire pourquoi.**
Les echecs residuels sont tous du cote du HARNAIS et jamais du jeu - voir la
section 12, qui distingue la regression que j'ai introduite (corrigee, avec ses
chiffres) de la flakiness pre-existante (desormais mesuree : le jeu se ferme en
0,1 s). Ils frappent un scenario different a chaque execution, ce qui est la
signature d'une variance d'automatisation et non d'un defaut.
Un run de reference entierement vert reste souhaitable ; il demande de traiter la
dette du collecteur de journal, qui n'est pas le sujet de cette phase.
### Verification visuelle
`tools\shot_daynight.ps1` produit **six captures de la MEME vue** a
3 / 6,5 / 9 / 13 / 18 / 21 h, horloge GELEE (`--time-scale=0`) et cadrage epingle
(`--start` + `--look`). Dans `build\daynight`.
Ce qu'elles montrent : la lumiere tourne d'est en ouest au fil de la journee, son
intensite suit, et le ciel passe du bleu de midi au bleu nuit. Le detecteur de
ciel du script de capture le chiffre tout seul, sans rien avoir a mesurer a la
main : **20,6 % de ciel a 13 h, 0,0 % a 21 h** - il ne compte que les pixels bleu
clair, et la nuit il n'y en a plus.
Rappel des trois pieges du projet, tous les trois rencontres pendant cette
session : `--look` doit etre epingle en plus de `--lock-input` (Phase 12), un
`vercora.exe` orphelin fausse toute mesure (Phase 19, et il a fallu en tuer un
au milieu des captures), et `powershell -File` aplatit les arguments - il relit
`--look=-90,-8` comme un nom de parametre, d'ou l'appel en processus dans
`shot_daynight.ps1`.
**Contraste adret/ubac** : aucune capture ne le montre, et c'est une limite
assumee. Le jeu n'a aucun indice visuel de temperature, donc un adret et un ubac
au meme instant se distinguent par leur ECLAIREMENT (visible dans les captures du
cycle) mais pas par leur chaleur. L'ecart thermique, lui, est mesure par les
tests headless : 14,7 C contre 10,7 C a midi. Un indice visuel - une teinte, une
brume de fond de vallee - est note comme amelioration future.
---
---
## 12. Le harnais Vulkan, et ce que cette phase lui a coute
Deux choses distinctes, qu'il ne faut pas confondre.
### (a) Une regression que j'ai introduite, mesuree et corrigee
La premiere version journalisait **deux lignes de meteo par seconde**, a cote de
la ligne de besoins qui existait deja. Le debit de journal a donc triple.
Le harnais Vulkan paie **un script-block PowerShell par ligne de journal**, et
son retard **croit avec le volume** — c'est la dette ouverte en Phase 17 et
comprise en Phase 22. Resultat immediat : le scenario H, le plus long
(220 s de journal continu), a echoue sur *"pas de sortie 20 s apres WM_CLOSE"* et
n'a collecte que **87 releves la ou il en attend 220**. Le jeu etait correct ;
c'est le collecteur qui ne suivait plus.
La cadence a ete resserree **deux fois** :
| Version | Volume ajoute sur le scenario H | Releves collectes |
|---|---|---|
| 2 lignes / seconde | ~440 lignes | **87** — echec |
| 2 lignes / 10 s | ~44 lignes | 235, puis **181** — echec marginal |
| 1 ligne / 30 s | **~7 lignes** | **236 / 240** sur deux essais |
La deuxieme valeur est instructive : elle *passait*, mais de justesse, et un run
ulterieur est retombe a 181 releves — assez pour perdre les derniers, donc pour
que la recuperation de la jauge (qui se lit dans les derniers) disparaisse. Une
correction qui passe de justesse n'est pas une correction.
Trente secondes ne coutent rien au depouillement : la meteo bouge a l'echelle de
l'heure de jeu, pas de la seconde reelle.
### (b) Une flakiness qui n'est PAS de cette phase, et qui est maintenant mesuree
Il reste des echecs *"pas de sortie 20 s apres WM_CLOSE"* qui frappent un
scenario different a chaque execution (H, puis E, puis D + G1 + G3, puis H de
nouveau), sans jamais aucun message `[Validation]` ni `[ERROR]`.
**Le jeu n'est pas en cause, et c'est desormais une mesure et non une
hypothese** : en fermant la fenetre par `CloseMainWindow()` et en chronometrant
la sortie du processus, on obtient **0,1 / 0,1 / 0,1 / 0,2 seconde** sur quatre
essais. Le jeu se ferme instantanement. Un *"pas de sortie apres 20 s"* est donc
un echec de LIVRAISON du message par le harnais, pas un blocage du jeu.
C'est la meme famille que la variance deja documentee pour A/B/G : le harnais
pilote par `PostMessage` (scancodes, pas de vraie souris), et le meme run peut
manquer une touche. Les executions ou un scenario echoue montrent d'ailleurs des
assertions de gameplay a `False` en amont (pas de decollage, pas d'entree en
mode editeur), pas seulement une fermeture ratee : ce sont des touches perdues.
---
## 13. Limites assumees et ameliorations futures
- **Ombre pluviometrique** — la barriere orographique renforce le versant au
vent, mais il n'y a pas de vraie ombre sous le vent au-dela de l'absence de
renforcement. Le cahier des charges le demandait simple pour cette session.
- **Nature du sol** — le velo ne connait qu'une humidite, pas un materiau. Le
LiDAR ne porte aucune information de nature de terrain (limite deja etablie en
Phase 22 pour les gisements).
- **Adherence en virage a velo** — pas touchee, voir §8.
- **Fermeture et decrochage en parapente** — pas modelises.
- **Neige** — `WeatherSample::snowing` est calcule et journalise, mais n'a
**aucun effet gameplay ni visuel**. Le champ existe pour ne rien avoir a
inventer le jour ou l'un des deux arrivera.
- **Precipitations visibles** — aucune. Il pleut dans les chiffres, pas a
l'ecran.
- **Ombres portees** — aucune, comme avant. Ni etoiles, ni lune, ni halo
solaire : le ciel est une couleur unie qui change avec l'heure, pas un ciel.
- **Vent sur la vegetation** — l'ondulation de l'herbe (Phase 18) est toujours
pilotee par un temps qui defile, pas par le vent local. Le brancher serait un
effet visuel gratuit maintenant que le vent existe en tout point.
- **Modele solaire** — pas d'equation du temps, pas de refraction, pas de
longitude. Les corrections omises valent au plus une quinzaine de minutes sur
les heures de lever et coucher, invisible dans une horloge acceleree douze
fois.
- **Surplombs et 2,5D** — inchange, toutes les limites des phases precedentes
s'appliquent.