How maxi-fr/simulate works
The product is a configuration-driven control-system simulator, extended with spacecraft dynamics and ADCS models. Its main workflow loads configuration, assembles multi-rate components, advances a closed loop, and records results; batch experiments are a separate execution option. The spacecraft package adds rigid-body/orbit modeling, effectors, environment and attitude utilities, plus estimation and measurement capabilities. Edges reflect the excerpts, SOURCE INDEX references, and README; unsampled runtime details are not inferred beyond those sources.
Main entry points: simulation.py Loop orchestrator · rigid_body.py Rigid-body dynamics · effector.py Actuators and effectors · measurement.py Spacecraft measurements
Components 23
Simulation engine
- CLI
src/simulate/main.py - Config loader
src/simulate/config.py - Loop orchestrator
src/simulate/simulation.py - Component and ZOH
src/simulate/component.py
Control components
- Dynamics
src/simulate/dynamics.py - Numerical integrators
src/simulate/integrator.py - Reference signals
src/simulate/reference.py - Sensors and measurements
src/simulate/sensor.py - State estimators
src/simulate/estimator.py - Controllers
src/simulate/controller.py
Logging and runs
- Logging backends
src/simulate/logger/base.py - Batch experiments
src/simulate/experiment.py
Spacecraft models
- Rigid-body dynamics
src/spacecraft/rigid_body.py - Actuators and effectors
src/spacecraft/effector.py - Orbit propagation
src/spacecraft/orbit_dynamics.py - Reference frames
src/spacecraft/frames.py - Quaternion math
src/spacecraft/quaternion.py - Space environment
src/spacecraft/environment.py - Environmental torques
src/spacecraft/disturbances.py - Spacecraft surfaces
src/spacecraft/surface.py - ADCS estimators
src/spacecraft/estimator.py - Spacecraft measurements
src/spacecraft/measurement.py
Other components
- Simulation user
Connections 43
- Simulation user → CLI: invokes
README.md - Simulation user → Config loader: provides configuration
README.md - CLI → Config loader: loads
src/simulate/main.py - CLI → Loop orchestrator: runs
src/simulate/main.py - CLI → Batch experiments: dispatches batches
src/simulate/main.py - Loop orchestrator → Config loader: builds components
src/simulate/simulation.py - Loop orchestrator → Dynamics: advances
src/simulate/simulation.py - Loop orchestrator → Reference signals: evaluates
src/simulate/simulation.py - Loop orchestrator → Sensors and measurements: samples
src/simulate/simulation.py - Loop orchestrator → State estimators: estimates state
src/simulate/simulation.py - Loop orchestrator → Controllers: computes control
src/simulate/simulation.py - Loop orchestrator → Logging backends: records results
src/simulate/simulation.py - Dynamics → Component and ZOH: inherits
src/simulate/dynamics.py - Reference signals → Component and ZOH: inherits
src/simulate/reference.py - Sensors and measurements → Component and ZOH: inherits
src/simulate/sensor.py - State estimators → Component and ZOH: inherits
src/simulate/estimator.py - Controllers → Component and ZOH: inherits
src/simulate/controller.py - Dynamics → Numerical integrators: integrates with
src/simulate/dynamics.py - State estimators → Numerical integrators: integrates with
src/simulate/estimator.py - Batch experiments → Loop orchestrator: runs configurations
src/simulate/experiment.py - Rigid-body dynamics → Dynamics: extends
src/spacecraft/rigid_body.py - Rigid-body dynamics → Actuators and effectors: composes
src/spacecraft/rigid_body.py - Rigid-body dynamics → Reference frames: uses
src/spacecraft/rigid_body.py - Rigid-body dynamics → Orbit propagation: uses
src/spacecraft/rigid_body.py - Rigid-body dynamics → Quaternion math: uses
src/spacecraft/rigid_body.py - Actuators and effectors → Space environment: queries
src/spacecraft/effector.py - Actuators and effectors → Environmental torques: uses
src/spacecraft/effector.py - Actuators and effectors → Spacecraft surfaces: uses
src/spacecraft/effector.py - Actuators and effectors → Reference frames: uses
src/spacecraft/effector.py - Actuators and effectors → Orbit propagation: uses
src/spacecraft/effector.py - Environmental torques → Space environment: queries
src/spacecraft/disturbances.py - Environmental torques → Quaternion math: uses
src/spacecraft/disturbances.py - Environmental torques → Spacecraft surfaces: uses
src/spacecraft/disturbances.py - Reference frames → Quaternion math: uses
src/spacecraft/frames.py - ADCS estimators → Orbit propagation: uses
src/spacecraft/estimator.py - ADCS estimators → Quaternion math: uses
src/spacecraft/estimator.py - Spacecraft measurements → Space environment: queries
src/spacecraft/measurement.py - Spacecraft measurements → Reference frames: uses
src/spacecraft/measurement.py - Spacecraft measurements → Quaternion math: uses
src/spacecraft/measurement.py - Spacecraft measurements → Rigid-body dynamics: reads state
src/spacecraft/measurement.py - Rigid-body dynamics → Loop orchestrator: runs as component
README.md - ADCS estimators → Loop orchestrator: runs as component
README.md - Spacecraft measurements → Loop orchestrator: runs as component
README.md