Module continuum_bridge
Expand description
Two-Way Rigid-Body ↔ Continuum Physics Coupling (continuum_bridge.rs).
Couples 3D XPBD RigidBody3D simulation directly with continuum engines:
- 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 theRigidBody3D. - 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 theRigidBody3D. - Botanical Biomechanics (
etalon_render::vegetation): Rigid-body collision impulse against a botanical stem inMetamerPlantGraph$\to$ elastic cantilever deflection (pitch_rad/bending_moment_nm) or modulus-of-rupture branch fracture when bending stress exceeds $\sigma_{\text{MOR}}$.
Structs§
- Botanical
Impact Outcome - Telemetry returned by rigid-body ↔ botanical metamer impact coupling.
- Hydro
Coupling Outcome - Telemetry returned by two-way hydrodynamic coupling.
- Soil
Coupling Outcome - Telemetry returned by two-way soil-rigid-body coupling.
Functions§
- couple_
rigid_ body_ with_ botanical_ stem - Couples a 3D rigid-body impact against
metamer_idxin aMetamerPlantGraph. - couple_
rigid_ body_ with_ hydro - Applies two-way 3D Archimedes buoyancy, wave-normal righting torque, and quadratic fluid drag
between a
RigidBody3Dand a [SimdGerstnerSpectrum] wavefield. - couple_
rigid_ body_ with_ soil - Applies two-way geotechnical force coupling between a
RigidBody3D(wheel, foot, boulder, or chassis) and aSoilMechanicsProfile.