Struct SoilMechanicsProfile
#[repr(C)]pub struct SoilMechanicsProfile {
pub cohesion_kpa: f32,
pub friction_angle_rad: f32,
pub bulk_density_kn_m3: f32,
pub pore_water_pressure_kpa: f32,
pub root_tensile_reinforcement_kpa: f32,
pub soil_tool_adhesion_kpa: f32,
pub bulking_factor: f32,
pub angle_of_repose_rad: f32,
pub unconfined_compressive_strength_kpa: f32,
}Expand description
Canonical geotechnical soil failure and physical mechanics profile.
Fields§
§cohesion_kpa: f32Effective cohesion $c’$ in kPa (pure sand ~0, loam ~10, dense clay ~50+).
friction_angle_rad: f32Effective internal friction angle $\phi$ in radians (sand ~0.60 rad / 34°, clay ~0.35 rad / 20°).
bulk_density_kn_m3: f32Soil unit weight / bulk density $\gamma$ in kN/m³ (typical 15.0 - 20.0 kN/m³).
pore_water_pressure_kpa: f32Pore water pressure $u$ in kPa (negative for matric suction in damp soil, positive in saturated mud).
root_tensile_reinforcement_kpa: f32Wu-Waldron root tensile cohesion reinforcement $\Delta c_{\text{root}}$ in kPa.
soil_tool_adhesion_kpa: f32Soil-tool adhesion $c_a$ in kPa (sticky clay adhering to tool face).
bulking_factor: f32Volumetric bulking expansion factor $B_f = V_{\text{loose}} / V_{\text{bank}}$ (typically 1.15 - 1.35).
angle_of_repose_rad: f32Critical angle of repose for loose spoil heap in radians ($\theta_r \approx \phi$).
unconfined_compressive_strength_kpa: f32Unconfined compressive strength $q_u$ in kPa (identifies lithic refusal threshold).
Implementations§
§impl SoilMechanicsProfile
impl SoilMechanicsProfile
pub fn humic_root_mat() -> SoilMechanicsProfile
pub fn humic_root_mat() -> SoilMechanicsProfile
Surface humic root-mat epipedon (Depth 1: 0–5 cm, dense subalpine grass roots).
pub fn loam() -> SoilMechanicsProfile
pub fn loam() -> SoilMechanicsProfile
Friable sandy loam topsoil (Depth 2: 5–15 cm).
pub fn illuvial_clay() -> SoilMechanicsProfile
pub fn illuvial_clay() -> SoilMechanicsProfile
Dense plastic illuvial clay (Depth 4: 30–60 cm).
pub fn saprolite() -> SoilMechanicsProfile
pub fn saprolite() -> SoilMechanicsProfile
Weathered gravelly saprolite / bedrock transition (Depth 5: 60–100 cm).
pub fn bedrock() -> SoilMechanicsProfile
pub fn bedrock() -> SoilMechanicsProfile
Solid lithic bedrock (granite / basalt).
pub fn with_seasonal_state(
&self,
temp_c: f32,
moisture_fraction: f32,
) -> SoilMechanicsProfile
pub fn with_seasonal_state( &self, temp_c: f32, moisture_fraction: f32, ) -> SoilMechanicsProfile
Adjusts soil mechanical resistance across diurnal freeze-thaw and annual seasons.
- $T \le 0^\circ\text{C}$: Cryo-cementation (needle ice / permafrost crust) causes cohesion and compressive strength to jump dramatically, leading to spade refusal.
- $S_w > 0.80$: Spring snowmelt or saturated rain induces positive pore pressure ($u > 0$), dropping effective stress while boosting clay-tool adhesion ($c_a$).
- $S_w < 0.20$: Summer drought creates strong matric suction ($u \ll 0$), baking clay into hard clods and generating airborne dust under mechanical impacts.
Trait Implementations§
§impl Clone for SoilMechanicsProfile
impl Clone for SoilMechanicsProfile
§fn clone(&self) -> SoilMechanicsProfile
fn clone(&self) -> SoilMechanicsProfile
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more