Skip to main content

Module continuum_bridge

Module continuum_bridge 

Expand description

Two-Way Rigid-Body ↔ Continuum Physics Coupling (continuum_bridge.rs).

Couples 3D XPBD RigidBody3D simulation directly with continuum engines:

  1. Geomechanics (environment::geomechanics): Normal contact force on soil strata $\to$ Bekker / Mohr–Coulomb plastic sinkage depth, Kozeny–Carman compaction (evaluate_soil_compaction), and rolling/bulldozing resistance impulse applied back to the RigidBody3D.
  2. Hydrodynamics (etalon_render::water_surface): Submerged 3D collider volume against [SimdGerstnerSpectrum] $\to$ 3D Archimedes upward buoyancy force, wave-normal righting torque, and quadratic fluid drag/lift applied to the RigidBody3D.
  3. Botanical Biomechanics (etalon_render::vegetation): Rigid-body collision impulse against a botanical stem in MetamerPlantGraph $\to$ elastic cantilever deflection (pitch_rad / bending_moment_nm) or modulus-of-rupture branch fracture when bending stress exceeds $\sigma_{\text{MOR}}$.

Structs§

BotanicalImpactOutcome
Telemetry returned by rigid-body ↔ botanical metamer impact coupling.
HydroCouplingOutcome
Telemetry returned by two-way hydrodynamic coupling.
SoilCouplingOutcome
Telemetry returned by two-way soil-rigid-body coupling.

Functions§

couple_rigid_body_with_botanical_stem
Couples a 3D rigid-body impact against metamer_idx in a MetamerPlantGraph.
couple_rigid_body_with_hydro
Applies two-way 3D Archimedes buoyancy, wave-normal righting torque, and quadratic fluid drag between a RigidBody3D and a [SimdGerstnerSpectrum] wavefield.
couple_rigid_body_with_soil
Applies two-way geotechnical force coupling between a RigidBody3D (wheel, foot, boulder, or chassis) and a SoilMechanicsProfile.