How fahadkhan-20/sih26054-digital-twin works
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: pipeline.py Twin Pipeline · server.py GCS API · train.py PINN Training · efi_status.py EFI Status Bridge
Components 21
Telemetry Ingestion
- Twin Pipeline
core/pipeline.py - CAN Decoder
core/telemetry/decoder.py - Telemetry Normalizer
core/telemetry/normalizer.py - Fault Injection
core/telemetry/fault_injector.py - Telemetry Schemas
core/telemetry_schema/schemas.py - Raw Data Recorder
core/telemetry/recorder.py
Engine Analysis
- Physics Twin
core/twin_core/physics_model.py - Virtual Sensors
core/virtual_sensors/estimators.py - Residual Observer
core/observer/observer_engine.py - Fault Diagnostics
core/diagnostics/fault_classifier.py - Wiener RUL
core/prognostics/wiener_rul.py - Twin Calibration
core/twin_core/calibrator.py
Operator & Downlink
- GCS API
gcs_api/server.py - GCS Dashboard
gcs_frontend/app.js - EFI Status Bridge
core/mavlink_bridge/efi_status.py
PINN Model
- PINN Dataset
pinn/dataset.py - PINN Model & Loss
pinn/model.py - PINN Training
pinn/train.py
Other components
- Engine / CAN Source
- GCS Operator
- MAVLink Consumer
Connections 18
- Engine / CAN Source → Twin Pipeline: sends frames
README.md - Twin Pipeline → CAN Decoder: decodes frames
core/pipeline.py - Twin Pipeline → Telemetry Normalizer: synchronizes signals
core/pipeline.py - Twin Pipeline → Fault Injection: injects faults
core/pipeline.py - Twin Pipeline → Physics Twin: steps twin
core/pipeline.py - Twin Pipeline → Virtual Sensors: estimates sensors
core/pipeline.py - Twin Pipeline → Residual Observer: evaluates residuals
core/pipeline.py - Twin Pipeline → Fault Diagnostics: classifies faults
core/pipeline.py - Twin Pipeline → Wiener RUL: predicts RUL
core/pipeline.py - Twin Pipeline → EFI Status Bridge: encodes status
core/pipeline.py - Twin Pipeline → Telemetry Schemas: returns packet
core/pipeline.py - GCS API → Twin Pipeline: runs processing
gcs_api/server.py - GCS API → Raw Data Recorder: uses recorder
gcs_api/server.py - GCS Operator → GCS Dashboard: views dashboard
README.md - EFI Status Bridge → MAVLink Consumer: downlinks EFI
README.md - PINN Training → PINN Dataset: loads data
pinn/train.py - PINN Training → PINN Model & Loss: trains model
pinn/train.py - Twin Calibration → Physics Twin: calibrates twin
core/twin_core/calibrator.py