commit 3be8691f0089b2f8afef886b02fabfff24261d6d Author: Theo Gastinel Date: Fri Oct 30 00:11:19 2026 +0100 Module physique: neige, etages, soleil (tests) Co-Authored-By: Claude Sonnet 5.5 diff --git a/physique/.gitignore b/physique/.gitignore new file mode 100644 index 0000000..2f7896d --- /dev/null +++ b/physique/.gitignore @@ -0,0 +1 @@ +target/ diff --git a/physique/Cargo.lock b/physique/Cargo.lock new file mode 100644 index 0000000..8a849f9 --- /dev/null +++ b/physique/Cargo.lock @@ -0,0 +1,7 @@ +# This file is automatically @generated by Cargo. +# It is not intended for manual editing. +version = 4 + +[[package]] +name = "physique" +version = "0.1.0" diff --git a/physique/Cargo.toml b/physique/Cargo.toml new file mode 100644 index 0000000..dafdd90 --- /dev/null +++ b/physique/Cargo.toml @@ -0,0 +1,6 @@ +[package] +name = "physique" +version = "0.1.0" +edition = "2021" + +[dependencies] diff --git a/physique/src/lib.rs b/physique/src/lib.rs new file mode 100644 index 0000000..cb3bc74 --- /dev/null +++ b/physique/src/lib.rs @@ -0,0 +1,150 @@ +//! Modele physique du Vercors (fonctions pures, sans reseau). Valeurs [A VERIFIER] contre donnees locales. + +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum Etage { Collineen, Montagnard, Subalpin, Alpin, Nival } + +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum Exposition { Adret, Ubac, Neutre } + +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum Meteo { Sec, Pluie, Neige } + +pub const GRADIENT_C_PAR_M: f32 = 0.0065; + +/// Temperature a l'altitude `alt_m` depuis une station de reference. +pub fn temp_a_altitude(temp_ref_c: f32, alt_ref_m: f32, alt_m: f32) -> f32 { + temp_ref_c - (alt_m - alt_ref_m) * GRADIENT_C_PAR_M +} + +/// Altitude de l'isotherme 0 C. +pub fn isotherme_zero_m(temp_ref_c: f32, alt_ref_m: f32) -> f32 { + alt_ref_m + temp_ref_c / GRADIENT_C_PAR_M +} + +/// Limite pluie-neige : isotherme 0 C abaissee de ~250 m (la neige descend sous le 0 C). +/// Plancher estival : hors saison la neige ne tient au sol qu'en haute altitude. +pub fn limite_neige_m(mois: u32, temp_ref_c: f32, alt_ref_m: f32) -> f32 { + let l = isotherme_zero_m(temp_ref_c, alt_ref_m) - 250.0; + let min = match mois { 6 | 9 => 1800.0, 7 | 8 => 2500.0, _ => 0.0 }; + l.max(min) +} + +/// Temperature moyenne mensuelle a 1000 m (zone Autrans/Meaudre) [A VERIFIER]. +pub fn temp_moyenne_1000m(mois: u32) -> f32 { + const T: [f32; 12] = [-1.5, -0.8, 2.0, 4.5, 9.0, 12.5, 15.0, 14.5, 10.5, 7.0, 2.0, -0.5]; + T[(mois.clamp(1, 12) - 1) as usize] +} + +/// Limite d'enneigement climatologique du sol (m) selon le mois [A VERIFIER]. +pub fn limite_enneigement_climato_m(mois: u32) -> f32 { + const L: [f32; 12] = [700.0, 800.0, 1100.0, 1700.0, 2300.0, 2800.0, 3200.0, 3200.0, 2700.0, 2000.0, 1200.0, 800.0]; + L[(mois.clamp(1, 12) - 1) as usize] +} + +/// Decalage d'altitude equivalent selon l'exposition (adret plus chaud). +pub fn decalage_exposition_m(e: Exposition) -> f32 { + match e { Exposition::Adret => 150.0, Exposition::Ubac => -150.0, Exposition::Neutre => 0.0 } +} + +/// Etage de vegetation (Prealpes du Nord) [A VERIFIER] : collinéen < 700, montagnard 700-1500 +/// (hetre-sapin), subalpin 1500-1900 (epicea, pin a crochets), alpin 1900-2400, nival au-dela. +pub fn etage_vegetation(alt_m: f32, expo: Exposition) -> Etage { + let a = alt_m - decalage_exposition_m(expo); + if a < 700.0 { Etage::Collineen } + else if a < 1500.0 { Etage::Montagnard } + else if a < 1900.0 { Etage::Subalpin } + else if a < 2400.0 { Etage::Alpin } + else { Etage::Nival } +} + +/// Jours d'enneigement du sol : ~30 j a 600 m, ~150 j a 1300 m, ~250 j a 2000 m [A VERIFIER]. +pub fn jours_enneigement(alt_m: f32) -> f32 { + (30.0 + (alt_m - 600.0) * 0.17).clamp(0.0, 330.0) +} + +/// Gel d'un lac : moyenne des minimas sur 7 j < -4 C. +pub fn lac_gele(temp_min_moy_7j_c: f32) -> bool { temp_min_moy_7j_c < -4.0 } + +/// Debit relatif au module annuel : crue de fonte avril-juin, etiage aout-septembre. +pub fn debit_relatif(mois: u32) -> f32 { + const D: [f32; 12] = [0.7, 0.7, 1.1, 1.8, 2.0, 1.4, 0.7, 0.5, 0.6, 1.0, 1.2, 0.9]; + D[(mois.clamp(1, 12) - 1) as usize] +} + +/// Fraction de feuillage (hetre) 0..=1 selon le jour de l'annee, retard d'altitude ~3 j/100 m. +pub fn feuillage(jour_annee: u32, alt_m: f32) -> f32 { + let dec = (alt_m - 800.0).max(0.0) / 100.0 * 3.0; + let j = jour_annee as f32; + let ouv = ((j - (105.0 + dec)) / 30.0).clamp(0.0, 1.0); + let chute = ((315.0 - dec - j) / 35.0).clamp(0.0, 1.0); + ouv.min(chute) +} + +/// Couche de neige 0..=8 (hauteur en couches Minecraft). +pub fn couche_neige(alt_m: f32, pente_deg: f32, expo: Exposition, mois: u32, meteo: Meteo) -> u8 { + let alt_eff = alt_m - decalage_exposition_m(expo); + let base = limite_enneigement_climato_m(mois); + let lim = match meteo { Meteo::Neige => base - 300.0, Meteo::Pluie => base + 300.0, Meteo::Sec => base }; + if alt_eff < lim || pente_deg > 50.0 { return 0; } + let h = ((alt_eff - lim) / 150.0 + 1.0).clamp(1.0, 8.0); + let k = if pente_deg > 35.0 { 0.5 } else { 1.0 }; + (h * k).round().clamp(0.0, 8.0) as u8 +} + +/// Lever / coucher du soleil (heures solaires vraies) par la declinaison. +pub fn lever_coucher_h(jour_annee: u32, lat_deg: f32) -> (f32, f32) { + let decl = 23.44_f32.to_radians() * ((360.0 / 365.0 * (jour_annee as f32 - 81.0)).to_radians()).sin(); + let phi = lat_deg.to_radians(); + let c = (-0.0145_f32 - phi.tan() * decl.tan()).clamp(-1.0, 1.0); + let ha = c.acos().to_degrees() / 15.0; + (12.0 - ha, 12.0 + ha) +} + +/// Ticks Minecraft (0..24000) : jour reel du lever au coucher mappe sur 0..12000, nuit sur 12000..24000. +pub fn tick_minecraft(heure_solaire: f32, lever: f32, coucher: f32) -> u32 { + let h = heure_solaire.rem_euclid(24.0); + let t = if h >= lever && h <= coucher { + (h - lever) / (coucher - lever) * 12000.0 + } else { + let nuit = 24.0 - (coucher - lever); + let dh = if h > coucher { h - coucher } else { h + 24.0 - coucher }; + 12000.0 + dh / nuit * 12000.0 + }; + (t as u32) % 24000 +} + +#[cfg(test)] +mod tests { + use super::*; + #[test] fn gradient() { assert!((temp_a_altitude(10.0, 1000.0, 2000.0) - 3.5).abs() < 1e-3); } + #[test] fn iso0() { assert!((isotherme_zero_m(6.5, 0.0) - 1000.0).abs() < 1.0); } + #[test] fn limite_ete() { assert!(limite_neige_m(7, 15.0, 1000.0) >= 2500.0); } + #[test] fn limite_hiver_basse() { assert!(limite_neige_m(1, -1.5, 1000.0) < 1000.0); } + #[test] fn etages() { + assert_eq!(etage_vegetation(500.0, Exposition::Neutre), Etage::Collineen); + assert_eq!(etage_vegetation(1000.0, Exposition::Neutre), Etage::Montagnard); + assert_eq!(etage_vegetation(1700.0, Exposition::Neutre), Etage::Subalpin); + assert_eq!(etage_vegetation(2100.0, Exposition::Neutre), Etage::Alpin); + assert_eq!(etage_vegetation(1600.0, Exposition::Ubac), Etage::Subalpin); + assert_eq!(etage_vegetation(1600.0, Exposition::Adret), Etage::Montagnard); + } + #[test] fn neige() { + assert_eq!(couche_neige(600.0, 10.0, Exposition::Neutre, 7, Meteo::Sec), 0); + assert!(couche_neige(1800.0, 10.0, Exposition::Neutre, 1, Meteo::Sec) >= 1); + assert_eq!(couche_neige(1800.0, 60.0, Exposition::Neutre, 1, Meteo::Sec), 0); + assert!(couche_neige(1000.0, 10.0, Exposition::Ubac, 1, Meteo::Sec) >= couche_neige(1000.0, 10.0, Exposition::Adret, 1, Meteo::Sec)); + } + #[test] fn feuilles() { + assert_eq!(feuillage(10, 900.0), 0.0); + assert_eq!(feuillage(180, 900.0), 1.0); + assert_eq!(feuillage(350, 900.0), 0.0); + } + #[test] fn soleil() { + let (l, c) = lever_coucher_h(172, 45.0); + assert!(c - l > 15.0); + let (l, c) = lever_coucher_h(355, 45.0); + assert!(c - l < 9.5); + assert!(tick_minecraft(12.0, l, c) < 12000); + } + #[test] fn divers() { assert!(debit_relatif(5) > debit_relatif(8)); assert!(lac_gele(-6.0)); assert!(jours_enneigement(2000.0) > jours_enneigement(800.0)); } +}