How ahireavadhut/majdhaar works
Aero Piston Engine Digital Twin ingests live or replayed CAN telemetry, turns frames into synchronized engine state, then combines an independent physics twin with analytical virtual sensors and a PINN observer to diagnose faults and estimate remaining useful life. The GCS presents the resulting health data; MAVLink provides an avionics downlink. Calibration, raw-data lineage, and PINN model training are supporting product capabilities. Several subsystem links are documented in the README or SOURCE INDEX rather than shown in excerpts, so uncertain runtime connections are omitted.
Main entry points: pipeline.py Digital twin pipeline · schemas.py Telemetry schemas · decoder.py CAN decoder · normalizer.py Telemetry normalizer
Components 21
Telemetry and lineage
- CAN decoder
core/telemetry/decoder.py - Telemetry normalizer
core/telemetry/normalizer.py - Telemetry schemas
core/telemetry_schema/schemas.py - Raw data recorder
core/telemetry/recorder.py - Run data archive
data/raw
Twin and inference
- Digital twin pipeline
core/pipeline.py - Fault injector
core/telemetry/fault_injector.py - Physics twin
core/twin_core/physics_model.py - Virtual sensors
core/virtual_sensors/estimators.py - PINN observer
core/observer/observer_engine.py
Health and prognostics
- Fault diagnostics
core/diagnostics/fault_classifier.py - Wiener RUL
core/prognostics/wiener_rul.py
Operator and avionics
- GCS API
gcs_api/server.py - GCS console
gcs_frontend/app.js - MAVLink EFI bridge
core/mavlink_bridge/efi_status.py
Calibration and PINN
- Baseline calibrator
core/twin_core/calibrator.py - PINN dataset
pinn/dataset.py - PINN model
pinn/model.py
Other components
- Engine / CAN bus
- Operator
- Avionics consumer
Connections 22
- Engine / CAN bus → CAN decoder: sends frames
README.md - CAN decoder → Telemetry normalizer: decoded signals
core/pipeline.py - Telemetry normalizer → Digital twin pipeline: normalized state
core/pipeline.py - Digital twin pipeline → Fault injector: injects faults
core/pipeline.py - Digital twin pipeline → Physics twin: advances model
core/pipeline.py - Digital twin pipeline → Virtual sensors: estimates sensors
core/pipeline.py - Digital twin pipeline → PINN observer: evaluates residuals
core/pipeline.py - Digital twin pipeline → Fault diagnostics: classifies faults
core/pipeline.py - Digital twin pipeline → Wiener RUL: predicts RUL
core/pipeline.py - Digital twin pipeline → MAVLink EFI bridge: encodes downlink
core/pipeline.py - Digital twin pipeline → Telemetry schemas: packages results
core/pipeline.py - CAN decoder → Telemetry schemas: produces frame data
core/telemetry/decoder.py - Telemetry normalizer → Telemetry schemas: builds state
core/telemetry/normalizer.py - Raw data recorder → Run data archive: reads and writes
core/telemetry/recorder.py - GCS API → Digital twin pipeline: uses pipeline
gcs_api/server.py - GCS API → Raw data recorder: uses recorder
gcs_api/server.py - Operator → GCS console: views dashboard
README.md - GCS console → GCS API: gets telemetry
README.md - Baseline calibrator → Physics twin: calibrates parameters
core/twin_core/calibrator.py - PINN dataset → Telemetry schemas: loads telemetry
pinn/dataset.py - PINN observer → PINN model: loads trained artifact
- MAVLink EFI bridge → Avionics consumer: downlinks EFI status
README.md