How alafadeli/engine_simulation works
This repository presents itself as an automotive engine simulator, but the sampled implementation establishes only a command-line shell and an application state/timing controller. The documented-by-code workflow is to launch the CLI, create an application, and—in interactive mode—dispatch commands such as start, step, pause, report, and reset. Engine, physics, telemetry, dashboard, and related modules exist in the tree, but their excerpts are empty, so their behavior and connections cannot be confirmed.
Main entry points: main.py Program entry · cli.py CLI commands · application.py Application state
Components 23
Command line
- Program entry
main.py - CLI commands
src/cli.py
Application runtime
- Application state
src/application.py - Configuration
src/config.py
Engine systems
- Engine
src/engine.py - Cylinder
src/cylinder.py - Crankshaft
src/crankshaft.py - Fuel system
src/fuel_system.py - Cooling system
src/cooling_system.py - Controls
src/controls.py - Load
src/load.py - Environment
src/environment.py - Faults
src/faults.py - Dashboard
src/dashboard.py - Telemetry
src/telemetry.py - Data models
src/models.py
Physics
- Physics facade
src/physics.py - Geometry
src/physics/geometry.py - Thermodynamics
src/physics/thermodynamics.py - Integration
src/physics/integration.py - Friction
src/physics/friction.py - Thermal physics
src/physics/thermal.py
Other components
- Operator
Connections 3
- Operator → Program entry: runs
main.py - Program entry → CLI commands: calls
main.py - CLI commands → Application state: creates and commands
src/cli.py