Skip to main content

Module continuum_3d

Module continuum_3d 

Expand description

Sector 3D Physics, Stress-Cleavage Fracture & Continuum Bridge (continuum_3d.rs).

Unites 3D continuum simulation primitives:

  • Analytical SDF landforms (SdfCollider for 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 .10d PROC1 dynamic stress-cleavage fracture (evaluate_fracture_impact with FractureMaterialProps) 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 and crate::geomechanics (Bekker/Mohr-Coulomb 6-layer soil sinkage & compaction), crate::hydro (Archimedes 3D buoyancy, Gerstner wave lift, and fluid drag), and crate::metamer_fspm (elastic cantilever stem deflection and modulus-of-rupture branch fracture).

Structs§

ContinuumBridge3D
Two-way continuum coupling bridge coordinating Geomechanics, Hydrodynamics, and Botanical Biomechanics.
FractureMaterialProps
Physical material cleavage properties for principled .10d PROC1 stress-cleavage fracture.
RoverState
Dynamic vehicle suspension state and kinematics wrapper for 4-wheel rover exploration.
SdfCollider
Analytical Signed Distance Field collision primitive for sector terrain landforms.
SectorPhysicsReceipt
Structured receipt verifying 3D physics, spatial queries, and continuum coupling in a sector.
SectorPhysicsWorld3D
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.
XpbdWorld3D
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_id world:

Type Aliases§

EcopunkSectorPhysicsWorld
Type alias preserving 100% compatibility with downstream sector physics consumers.