Module continuum_3d
Expand description
Sector 3D Physics, Stress-Cleavage Fracture & Continuum Bridge (continuum_3d.rs).
Unites 3D continuum simulation primitives:
- Analytical SDF landforms (
SdfColliderfor granite tors, Silurian karst limestone outcrops, Hawkesbury sandstone ledges, and river boulder bars) and B-Rep colliders (ColliderShape3D). - Zero-heap dynamic broadphase BVH (
BroadphaseBvh) with fat-AABB hysteresis and fast 3D spatial queries (cast_ray,cast_sphere,cast_capsule,overlap_aabb). - 64 Hz deterministic Extended Position-Based Dynamics (
XpbdWorld3D) stepping dynamic boulders, fallen timber logs, articulated fauna ragdolls (ArticulatedRagdoll), and 6-DOF PGA Motor joints (BallMotorJoint,RevoluteMotorJoint,FixedMotorJoint,SpringSuspensionJoint). - Principled
.10dPROC1dynamic stress-cleavage fracture (evaluate_fracture_impactwithFractureMaterialProps) splitting weathered sandstone/karst boulders or brittle deadwood limbs along their principal stress cleavage plane while strictly conserving linear and angular momentum. - Kinematic 3D capsule character controller (
CharacterController::step_character_3d) with slide-and-collide planes, stair-stepping over river cobbles, ceiling overhang collision in Yarrangobilly karst caves, and moving platform velocity inheritance. - 4-wheel rover vehicle kinematics (
RoverState::step_3d) with sphere-cast independent suspension. - Two-way continuum coupling (
step_continuum_coupling_3d/ContinuumBridge3D) between 3D rigid bodies andcrate::geomechanics(Bekker/Mohr-Coulomb 6-layer soil sinkage & compaction),crate::hydro(Archimedes 3D buoyancy, Gerstner wave lift, and fluid drag), andcrate::metamer_fspm(elastic cantilever stem deflection and modulus-of-rupture branch fracture).
Structs§
- Continuum
Bridge3D - Two-way continuum coupling bridge coordinating Geomechanics, Hydrodynamics, and Botanical Biomechanics.
- Fracture
Material Props - Physical material cleavage properties for principled
.10dPROC1stress-cleavage fracture. - Rover
State - Dynamic vehicle suspension state and kinematics wrapper for 4-wheel rover exploration.
- SdfCollider
- Analytical Signed Distance Field collision primitive for sector terrain landforms.
- Sector
Physics Receipt - Structured receipt verifying 3D physics, spatial queries, and continuum coupling in a sector.
- Sector
Physics World3D - Unified sector physics simulation world coordinating 3D XPBD rigid bodies, analytical SDF terrain, character controller, rover kinematics, ragdolls, dynamic fracture, and two-way continuum coupling.
- Xpbd
World3D - 64 Hz deterministic Extended Position-Based Dynamics (XPBD) rigid-body physics world.
Constants§
- FIXED_
TIMESTEP_ 64HZ - Standard deterministic simulation timestep at 64 Hz ($1/64\text{ s} = 0.015625\text{ s}$).
- MAX_
SECTOR_ COLLIDERS - Maximum number of active colliders in a sector physics simulation world.
- MAX_
SECTOR_ JOINTS - Maximum number of joint constraints in a single sector world.
- MAX_
SECTOR_ MANIFOLDS - Maximum number of persistent contact manifolds allocated per sector.
Functions§
- run_
sector_ physics_ verification_ step - Executes a complete deterministic verification pass on the designated
sector_idworld:
Type Aliases§
- Ecopunk
Sector Physics World - Type alias preserving 100% compatibility with downstream sector physics consumers.