astrodyn_interactions 0.1.1

Aerodynamic drag, SRP, gravity-gradient torque, shadow, and contact for the astrodyn orbital-dynamics pipeline
Documentation

astrodyn_interactions

Surface interactions — aerodynamic drag, solar radiation pressure, gravity-gradient torque, shadow geometry, contact, thermal — for the astrodyn_bevy workspace.

Ports models/interactions/ and the surface-model utilities under models/utils/ from NASA JEOD v5.4.0.

Layered architecture

astrodyn_bevy        (Bevy ECS adapter, mission code)
   ↓
astrodyn         (orchestration; sums forces into TotalForce)
   ↓
astrodyn_interactions ←  this crate (pure Rust, zero Bevy)
   ↓
astrodyn_atmosphere, astrodyn_quantities

Each module produces a force, torque, or environmental scalar at a vehicle position. The orchestration that sums them into a body's astrodyn_dynamics::TotalForce lives in astrodyn.

Public surface

  • aero_drag (scalar-Cd) and flat_plate_aero (per-facet) — aerodynamic drag.
  • radiation_pressure — solar flux against a surface model with absorption / specular / diffuse coefficients.
  • shadow — umbra / penumbra geometry. earth_lighting extends with Earth-albedo and IR contributions.
  • gravity_torque — cross product of inertia tensor and gravity-gradient tensor through body attitude.
  • surface_model — SurfaceFacet, ArticulatedFacet, SurfaceShape — per-facet geometry shared by aero / SRP / contact / thermal.
  • contact — collision / contact response.
  • thermal_rider — per-facet power balance.

See also