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 moreimpl Copy for SoilMechanicsProfile
§impl Debug for SoilMechanicsProfile
impl Debug for SoilMechanicsProfile
§impl Default for SoilMechanicsProfile
impl Default for SoilMechanicsProfile
§fn default() -> SoilMechanicsProfile
fn default() -> SoilMechanicsProfile
§impl PartialEq for SoilMechanicsProfile
impl PartialEq for SoilMechanicsProfile
impl StructuralPartialEq for SoilMechanicsProfile
Auto Trait Implementations§
impl Freeze for SoilMechanicsProfile
impl RefUnwindSafe for SoilMechanicsProfile
impl Send for SoilMechanicsProfile
impl Sync for SoilMechanicsProfile
impl Unpin for SoilMechanicsProfile
impl UnsafeUnpin for SoilMechanicsProfile
impl UnwindSafe for SoilMechanicsProfile
Blanket Implementations§
§impl<S, A> Aggregate<Result<S, Error>> for Awhere
A: Aggregate<S>,
impl<S, A> Aggregate<Result<S, Error>> for Awhere
A: Aggregate<S>,
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more