# alafadeli/engine_simulation architecture

> Architecture diagram of the GitHub repository alafadeli/engine_simulation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alafadeli/engine_simulation
- Repository: https://github.com/alafadeli/engine_simulation

## Overview

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`](https://github.com/alafadeli/engine_simulation/blob/main/main.py) (Program entry), [`src/cli.py`](https://github.com/alafadeli/engine_simulation/blob/main/src/cli.py) (CLI commands), [`src/application.py`](https://github.com/alafadeli/engine_simulation/blob/main/src/application.py) (Application state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Command line"]
  node_main["Program entry<br/>[main.py]"]
  node_cli["CLI commands<br/>[cli.py]"]
end

subgraph group_runtime["Application runtime"]
  node_application["Application state<br/>[application.py]"]
  node_config["Configuration<br/>[config.py]"]
end

subgraph group_engine["Engine systems"]
  node_engine["Engine<br/>[engine.py]"]
  node_cylinder["Cylinder<br/>[cylinder.py]"]
  node_crankshaft["Crankshaft<br/>[crankshaft.py]"]
  node_fuel["Fuel system<br/>[fuel_system.py]"]
  node_cooling["Cooling system<br/>[cooling_system.py]"]
  node_controls["Controls<br/>[controls.py]"]
  node_load["Load<br/>[load.py]"]
  node_environment["Environment<br/>[environment.py]"]
  node_faults["Faults<br/>[faults.py]"]
  node_dashboard["Dashboard<br/>[dashboard.py]"]
  node_telemetry["Telemetry<br/>[telemetry.py]"]
  node_models["Data models<br/>[models.py]"]
end

subgraph group_physics["Physics"]
  node_physics["Physics facade<br/>[physics.py]"]
  node_geometry["Geometry<br/>[geometry.py]"]
  node_thermodynamics["Thermodynamics<br/>[thermodynamics.py]"]
  node_integration["Integration<br/>[integration.py]"]
  node_friction["Friction<br/>[friction.py]"]
  node_thermal["Thermal physics<br/>[thermal.py]"]
end

node_user(("Operator"))

node_user -->|"runs"| node_main
node_main -->|"calls"| node_cli
node_cli -->|"creates and commands"| node_application

click node_main "https://github.com/alafadeli/engine_simulation/blob/main/main.py"
click node_cli "https://github.com/alafadeli/engine_simulation/blob/main/src/cli.py"
click node_application "https://github.com/alafadeli/engine_simulation/blob/main/src/application.py"
click node_engine "https://github.com/alafadeli/engine_simulation/blob/main/src/engine.py"
click node_cylinder "https://github.com/alafadeli/engine_simulation/blob/main/src/cylinder.py"
click node_crankshaft "https://github.com/alafadeli/engine_simulation/blob/main/src/crankshaft.py"
click node_fuel "https://github.com/alafadeli/engine_simulation/blob/main/src/fuel_system.py"
click node_cooling "https://github.com/alafadeli/engine_simulation/blob/main/src/cooling_system.py"
click node_controls "https://github.com/alafadeli/engine_simulation/blob/main/src/controls.py"
click node_load "https://github.com/alafadeli/engine_simulation/blob/main/src/load.py"
click node_environment "https://github.com/alafadeli/engine_simulation/blob/main/src/environment.py"
click node_faults "https://github.com/alafadeli/engine_simulation/blob/main/src/faults.py"
click node_dashboard "https://github.com/alafadeli/engine_simulation/blob/main/src/dashboard.py"
click node_telemetry "https://github.com/alafadeli/engine_simulation/blob/main/src/telemetry.py"
click node_models "https://github.com/alafadeli/engine_simulation/blob/main/src/models.py"
click node_config "https://github.com/alafadeli/engine_simulation/blob/main/src/config.py"
click node_physics "https://github.com/alafadeli/engine_simulation/blob/main/src/physics.py"
click node_geometry "https://github.com/alafadeli/engine_simulation/blob/main/src/physics/geometry.py"
click node_thermodynamics "https://github.com/alafadeli/engine_simulation/blob/main/src/physics/thermodynamics.py"
click node_integration "https://github.com/alafadeli/engine_simulation/blob/main/src/physics/integration.py"
click node_friction "https://github.com/alafadeli/engine_simulation/blob/main/src/physics/friction.py"
click node_thermal "https://github.com/alafadeli/engine_simulation/blob/main/src/physics/thermal.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_cli toneBlue
class node_application,node_config toneAmber
class node_engine,node_cylinder,node_crankshaft,node_fuel,node_cooling,node_controls,node_load,node_environment,node_faults,node_dashboard,node_telemetry,node_models toneMint
class node_physics,node_geometry,node_thermodynamics,node_integration,node_friction,node_thermal toneRose
class node_user toneIndigo
```

## Components

### Command line

- [Program entry](https://github.com/alafadeli/engine_simulation/blob/main/main.py): `main.py`
- [CLI commands](https://github.com/alafadeli/engine_simulation/blob/main/src/cli.py): `src/cli.py`

### Application runtime

- [Application state](https://github.com/alafadeli/engine_simulation/blob/main/src/application.py): `src/application.py`
- [Configuration](https://github.com/alafadeli/engine_simulation/blob/main/src/config.py): `src/config.py`

### Engine systems

- [Engine](https://github.com/alafadeli/engine_simulation/blob/main/src/engine.py): `src/engine.py`
- [Cylinder](https://github.com/alafadeli/engine_simulation/blob/main/src/cylinder.py): `src/cylinder.py`
- [Crankshaft](https://github.com/alafadeli/engine_simulation/blob/main/src/crankshaft.py): `src/crankshaft.py`
- [Fuel system](https://github.com/alafadeli/engine_simulation/blob/main/src/fuel_system.py): `src/fuel_system.py`
- [Cooling system](https://github.com/alafadeli/engine_simulation/blob/main/src/cooling_system.py): `src/cooling_system.py`
- [Controls](https://github.com/alafadeli/engine_simulation/blob/main/src/controls.py): `src/controls.py`
- [Load](https://github.com/alafadeli/engine_simulation/blob/main/src/load.py): `src/load.py`
- [Environment](https://github.com/alafadeli/engine_simulation/blob/main/src/environment.py): `src/environment.py`
- [Faults](https://github.com/alafadeli/engine_simulation/blob/main/src/faults.py): `src/faults.py`
- [Dashboard](https://github.com/alafadeli/engine_simulation/blob/main/src/dashboard.py): `src/dashboard.py`
- [Telemetry](https://github.com/alafadeli/engine_simulation/blob/main/src/telemetry.py): `src/telemetry.py`
- [Data models](https://github.com/alafadeli/engine_simulation/blob/main/src/models.py): `src/models.py`

### Physics

- [Physics facade](https://github.com/alafadeli/engine_simulation/blob/main/src/physics.py): `src/physics.py`
- [Geometry](https://github.com/alafadeli/engine_simulation/blob/main/src/physics/geometry.py): `src/physics/geometry.py`
- [Thermodynamics](https://github.com/alafadeli/engine_simulation/blob/main/src/physics/thermodynamics.py): `src/physics/thermodynamics.py`
- [Integration](https://github.com/alafadeli/engine_simulation/blob/main/src/physics/integration.py): `src/physics/integration.py`
- [Friction](https://github.com/alafadeli/engine_simulation/blob/main/src/physics/friction.py): `src/physics/friction.py`
- [Thermal physics](https://github.com/alafadeli/engine_simulation/blob/main/src/physics/thermal.py): `src/physics/thermal.py`

### Other components

- **Operator**

## Connections

- Operator → Program entry: runs (evidence: `main.py`)
- Program entry → CLI commands: calls (evidence: `main.py`)
- CLI commands → Application state: creates and commands (evidence: `src/cli.py`)
