# fahadkhan-20/sih26054-digital-twin architecture

> Architecture diagram of the GitHub repository fahadkhan-20/sih26054-digital-twin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fahadkhan-20/sih26054-digital-twin
- Repository: https://github.com/fahadkhan-20/sih26054-digital-twin

## Overview

Aero Piston Engine Digital Twin is an engine-health monitoring and prognostics system with a Ground Control Station and MAVLink downlink. Its main workflow decodes CAN frames, synchronizes telemetry, runs physics and analytical estimates, then produces observer, fault, and remaining-life results. The API also uses the raw-data recorder; the README documents the dashboard and major capabilities. Edges follow the pipeline excerpt, SOURCE INDEX references, or README; unsampled subsystem internals and UI-to-API wiring are not inferred.

Main entry points: [`core/pipeline.py`](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/pipeline.py) (Twin Pipeline), [`gcs_api/server.py`](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/gcs_api/server.py) (GCS API), [`pinn/train.py`](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/pinn/train.py) (PINN Training), [`core/mavlink_bridge/efi_status.py`](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/mavlink_bridge/efi_status.py) (EFI Status Bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Telemetry Ingestion"]
  node_pipeline["Twin Pipeline<br/>[pipeline.py]"]
  node_decoder["CAN Decoder<br/>[decoder.py]"]
  node_normalizer["Telemetry Normalizer<br/>[normalizer.py]"]
  node_faultinjector["Fault Injection<br/>[fault_injector.py]"]
  node_schemas["Telemetry Schemas<br/>[schemas.py]"]
  node_recorder[("Raw Data Recorder<br/>[recorder.py]")]
end

subgraph group_analysis["Engine Analysis"]
  node_physics["Physics Twin<br/>[physics_model.py]"]
  node_virtual["Virtual Sensors<br/>[estimators.py]"]
  node_observer["Residual Observer<br/>[observer_engine.py]"]
  node_diagnostics["Fault Diagnostics"]
  node_prognostics["Wiener RUL<br/>[wiener_rul.py]"]
  node_calibrator["Twin Calibration<br/>[calibrator.py]"]
end

subgraph group_delivery["Operator &amp; Downlink"]
  node_api["GCS API<br/>[server.py]"]
  node_dashboard["GCS Dashboard<br/>[app.js]"]
  node_mavlink["EFI Status Bridge<br/>[efi_status.py]"]
end

subgraph group_learning["PINN Model"]
  node_dataset["PINN Dataset<br/>[dataset.py]"]
  node_pinnmodel["PINN Model &amp; Loss<br/>[model.py]"]
  node_trainer["PINN Training<br/>[train.py]"]
end

node_engine(("Engine / CAN Source"))
node_user(("GCS Operator"))
node_autopilot(("MAVLink Consumer"))

node_engine -->|"sends frames"| node_pipeline
node_pipeline -->|"decodes frames"| node_decoder
node_pipeline -->|"synchronizes signals"| node_normalizer
node_pipeline -->|"injects faults"| node_faultinjector
node_pipeline -->|"steps twin"| node_physics
node_pipeline -->|"estimates sensors"| node_virtual
node_pipeline -->|"evaluates residuals"| node_observer
node_pipeline -->|"classifies faults"| node_diagnostics
node_pipeline -->|"predicts RUL"| node_prognostics
node_pipeline -->|"encodes status"| node_mavlink
node_pipeline -->|"returns packet"| node_schemas
node_api -->|"runs processing"| node_pipeline
node_api -->|"uses recorder"| node_recorder
node_user -->|"views dashboard"| node_dashboard
node_mavlink -->|"downlinks EFI"| node_autopilot
node_trainer -->|"loads data"| node_dataset
node_trainer -->|"trains model"| node_pinnmodel
node_calibrator -->|"calibrates twin"| node_physics

click node_pipeline "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/pipeline.py"
click node_decoder "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/telemetry/decoder.py"
click node_normalizer "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/telemetry/normalizer.py"
click node_faultinjector "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/telemetry/fault_injector.py"
click node_schemas "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/telemetry_schema/schemas.py"
click node_recorder "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/telemetry/recorder.py"
click node_physics "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/twin_core/physics_model.py"
click node_virtual "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/virtual_sensors/estimators.py"
click node_observer "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/observer/observer_engine.py"
click node_diagnostics "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/diagnostics/fault_classifier.py"
click node_prognostics "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/prognostics/wiener_rul.py"
click node_calibrator "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/twin_core/calibrator.py"
click node_api "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/gcs_api/server.py"
click node_dashboard "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/gcs_frontend/app.js"
click node_mavlink "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/mavlink_bridge/efi_status.py"
click node_dataset "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/pinn/dataset.py"
click node_pinnmodel "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/pinn/model.py"
click node_trainer "https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/pinn/train.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_pipeline,node_decoder,node_normalizer,node_faultinjector,node_schemas,node_recorder toneBlue
class node_physics,node_virtual,node_observer,node_diagnostics,node_prognostics,node_calibrator toneAmber
class node_api,node_dashboard,node_mavlink toneMint
class node_dataset,node_pinnmodel,node_trainer toneRose
class node_engine,node_user,node_autopilot toneIndigo
```

## Components

### Telemetry Ingestion

- [Twin Pipeline](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/pipeline.py): `core/pipeline.py`
- [CAN Decoder](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/telemetry/decoder.py): `core/telemetry/decoder.py`
- [Telemetry Normalizer](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/telemetry/normalizer.py): `core/telemetry/normalizer.py`
- [Fault Injection](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/telemetry/fault_injector.py): `core/telemetry/fault_injector.py`
- [Telemetry Schemas](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/telemetry_schema/schemas.py): `core/telemetry_schema/schemas.py`
- [Raw Data Recorder](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/telemetry/recorder.py): `core/telemetry/recorder.py`

### Engine Analysis

- [Physics Twin](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/twin_core/physics_model.py): `core/twin_core/physics_model.py`
- [Virtual Sensors](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/virtual_sensors/estimators.py): `core/virtual_sensors/estimators.py`
- [Residual Observer](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/observer/observer_engine.py): `core/observer/observer_engine.py`
- [Fault Diagnostics](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/diagnostics/fault_classifier.py): `core/diagnostics/fault_classifier.py`
- [Wiener RUL](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/prognostics/wiener_rul.py): `core/prognostics/wiener_rul.py`
- [Twin Calibration](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/twin_core/calibrator.py): `core/twin_core/calibrator.py`

### Operator & Downlink

- [GCS API](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/gcs_api/server.py): `gcs_api/server.py`
- [GCS Dashboard](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/gcs_frontend/app.js): `gcs_frontend/app.js`
- [EFI Status Bridge](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/core/mavlink_bridge/efi_status.py): `core/mavlink_bridge/efi_status.py`

### PINN Model

- [PINN Dataset](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/pinn/dataset.py): `pinn/dataset.py`
- [PINN Model & Loss](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/pinn/model.py): `pinn/model.py`
- [PINN Training](https://github.com/fahadkhan-20/sih26054-digital-twin/blob/main/pinn/train.py): `pinn/train.py`

### Other components

- **Engine / CAN Source**
- **GCS Operator**
- **MAVLink Consumer**

## Connections

- Engine / CAN Source → Twin Pipeline: sends frames (evidence: `README.md`)
- Twin Pipeline → CAN Decoder: decodes frames (evidence: `core/pipeline.py`)
- Twin Pipeline → Telemetry Normalizer: synchronizes signals (evidence: `core/pipeline.py`)
- Twin Pipeline → Fault Injection: injects faults (evidence: `core/pipeline.py`)
- Twin Pipeline → Physics Twin: steps twin (evidence: `core/pipeline.py`)
- Twin Pipeline → Virtual Sensors: estimates sensors (evidence: `core/pipeline.py`)
- Twin Pipeline → Residual Observer: evaluates residuals (evidence: `core/pipeline.py`)
- Twin Pipeline → Fault Diagnostics: classifies faults (evidence: `core/pipeline.py`)
- Twin Pipeline → Wiener RUL: predicts RUL (evidence: `core/pipeline.py`)
- Twin Pipeline → EFI Status Bridge: encodes status (evidence: `core/pipeline.py`)
- Twin Pipeline → Telemetry Schemas: returns packet (evidence: `core/pipeline.py`)
- GCS API → Twin Pipeline: runs processing (evidence: `gcs_api/server.py`)
- GCS API → Raw Data Recorder: uses recorder (evidence: `gcs_api/server.py`)
- GCS Operator → GCS Dashboard: views dashboard (evidence: `README.md`)
- EFI Status Bridge → MAVLink Consumer: downlinks EFI (evidence: `README.md`)
- PINN Training → PINN Dataset: loads data (evidence: `pinn/train.py`)
- PINN Training → PINN Model & Loss: trains model (evidence: `pinn/train.py`)
- Twin Calibration → Physics Twin: calibrates twin (evidence: `core/twin_core/calibrator.py`)
