Corrélations multiples

docs/07 - Corrélations multiples/index.md

@@ -2,12 +2,42 @@
 
 ## Hexbin colorés
 
+Les nuages de points tri-variés saturent vite : on regroupe ici les points sur une grille hexagonale et on colore chaque case par une statistique de la 3ᵉ variable (max/médiane/moyenne selon les besoins). Cela limite le bruit des outliers et met en évidence les régimes dominants plutôt que les valeurs isolées. Les scénarios sont décrits dans `meteo/correlation_presets.py` et exécutés via un helper générique (`meteo.plots.hexbin`) pour rester réutilisables ailleurs dans le dépôt.
+
 ```shell
-python "docs/06 - Corrélations multiples/scripts/plot_hexbin_explorations.py"
+python "docs/07 - Corrélations multiples/scripts/plot_hexbin_explorations.py"
 ```
 
-![](figures/hexbin_explorations/hexbin_lux_humidity_color_temp.png)
+### Température vs humidité — couleur = pluie (max)
 
-![](figures/hexbin_explorations/hexbin_pressure_rain_color_wind.png)
+Plafond d'humidité quasi systématique sous 5–10 °C, et même quand la température remonte, la pluie ne survient que dans une bande 8–16 °C où l'humidité reste >90 %. L'agrégat `max` met en valeur les épisodes pluvieux rares.
 
-![](figures/hexbin_explorations/hexbin_temp_humidity_color_rain.png)
+![Température vs humidité, couleur pluie](./figures/hexbin_explorations/hexbin_temp_humidity_color_rain.png)
+
+### Température vs élévation solaire — couleur = humidité (médiane)
+
+La courbe en cloche suit le soleil : températures les plus hautes autour de 60° d'élévation, tandis que l'humidité médiane dégringole dès que le soleil est positif puis remonte au crépuscule, ce qui matérialise l'assèchement diurne.
+
+![Température vs élévation solaire, couleur humidité](./figures/hexbin_explorations/hexbin_sunelev_temp_color_humidity.png)
+
+### Pression vs pluie — couleur = vent (médiane)
+
+La matrice est clairsemée (pluie rare), mais les cases actives se concentrent sous ~1015 hPa avec des médianes de vent plus élevées, signe que les épisodes pluvieux et venteux coïncident surtout avec des pressions modestes.
+
+![Pression vs pluie, couleur vent](./figures/hexbin_explorations/hexbin_pressure_rain_color_wind.png)
+
+### Humidité vs illuminance — couleur = température (moyenne)
+
+Deux régimes se détachent : nuits très humides et fraîches (illuminance proche de zéro), journées sèches et plus chaudes. La température moyenne colorée rend visibles les transitions plus fraîches sous ciel couvert.
+
+![Humidité vs illuminance, couleur température](./figures/hexbin_explorations/hexbin_lux_humidity_color_temp.png)
+
+### Élévation solaire vs illuminance — couleur = pluie (max)
+
+Le nuage suit la diagonale « géométrie du soleil → lumière attendue », avec des cases assombries (illuminance faible malgré un soleil haut) où la pluie maximale ressort : on visualise directement l'impact d'un ciel très chargé sur l'apport lumineux.
+
+![Élévation solaire vs illuminance, couleur pluie](./figures/hexbin_explorations/hexbin_sunelev_lux_color_rain.png)
+
+## Conclusion
+
+Ces hexbins confirment les mécanismes physiques attendus : le rayonnement solaire chauffe et assèche, l’humidité suit la capacité de l’air en vapeur, la pluie survient surtout sous pression plus basse et lumière écrasée par les nuages. Mais notre jeu s’arrête en novembre : il manque la saison froide, donc les régimes hivernaux (neige, pluies froides, journées très courtes, plafond d’humidité quasi permanent) restent invisibles. Toute généralisation doit tenir compte de cette lacune saisonnière ; il faudrait compléter la série ou intégrer des données externes (nébulosité, contexte synoptique) pour confirmer ces motifs en hiver.

docs/07 - Corrélations multiples/scripts/plot_hexbin_explorations.py

@@ -9,8 +9,7 @@ if str(PROJECT_ROOT) not in sys.path:
     sys.path.insert(0, str(PROJECT_ROOT))
 
 from meteo.dataset import load_raw_csv
-from meteo.variables import VARIABLES_BY_KEY
-from meteo.plots import plot_hexbin_with_third_variable
+from meteo.plots import generate_hexbin_scenarios
 from meteo.correlation_presets import DEFAULT_HEXBIN_SCENARIOS
 
 
@@ -30,37 +29,19 @@ def main() -> None:
     print(f"  Colonnes : {list(df.columns)}")
     print()
 
-    for scenario in DEFAULT_HEXBIN_SCENARIOS:
-        var_x = VARIABLES_BY_KEY[scenario.key_x]
-        var_y = VARIABLES_BY_KEY[scenario.key_y]
-        var_color = VARIABLES_BY_KEY[scenario.key_color]
+    results = generate_hexbin_scenarios(
+        df=df,
+        scenarios=DEFAULT_HEXBIN_SCENARIOS,
+        base_output_dir=OUTPUT_DIR,
+        cmap="magma",
+    )
 
-        filename = scenario.filename
-        output_path = OUTPUT_DIR / filename
-
-        reduce_func = scenario.get_reduce_func()
-        reduce_label = scenario.get_reduce_label()
-
-        gridsize = scenario.gridsize
-        mincnt = scenario.mincnt
-
-        description = scenario.description
-        print(f"→ Hexbin {var_y.key} vs {var_x.key} (couleur = {var_color.key})")
-        print(f"   {description}")
-
-        plot_hexbin_with_third_variable(
-            df=df,
-            var_x=var_x,
-            var_y=var_y,
-            var_color=var_color,
-            output_path=output_path,
-            gridsize=gridsize,
-            mincnt=mincnt,
-            reduce_func=reduce_func,
-            reduce_func_label=reduce_label,
-            cmap="magma",
-        )
-        print(f"   ✔ Graphique enregistré : {output_path}")
+    for result in results:
+        scenario = result.scenario
+        print(f"→ Hexbin {result.var_y.key} vs {result.var_x.key} (couleur = {result.var_color.key})")
+        print(f"   {scenario.description}")
+        print(f"   Points valides : {result.point_count}")
+        print(f"   ✔ Graphique enregistré : {result.output_path}")
         print()
 
     print("✔ Tous les graphiques hexbin ont été générés.")