Fichiers
vercora/NOTES-PHASE23.md
T
2026-10-11 01:54:18 +02:00

Brut Annotations Historique

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.