How sumitrajapure1308/drdo-uav-enginetwin works
AeroTwin-MALE is a real-time digital-twin and health-monitoring system for MALE UAV piston engines. Its principal workflow streams engine telemetry through a FastAPI service, synchronizes a physics-based engine model, evaluates health and faults, and presents live status and mission-reliability information in the Ground Control Station (GCS). Operators can issue mission and fault commands; recorded or uploaded flight data can also be analyzed into maintenance advisories and debrief reports. The README documents additional AI, sensor-redundancy, and fleet capabilities; the sampled excerpts do not establish all of their runtime wiring.
Main entry points: server.py FastAPI Service · cli.py Batch Analysis CLI · digital_twin_engine.py Twin Synchronizer · app.js GCS Dashboard
Components 23
Telemetry and Simulation
- Mission Simulator
src/simulation/mission_simulator.py - Mission Recorder
src/simulation/mission_recorder.py - Telemetry and State
src/core/state.py - SocketCAN Bridge
src/core/socketcan_bridge.py - Recorded Missions
src/simulation/mission_recorder.py
Digital Twin
- Twin Synchronizer
src/core/digital_twin_engine.py - Engine Physics Models
src/physics/thermodynamic_cycle.py - Sensor Fusion EKF
src/core/sensor_fusion.py
Health and Prognostics
- Sensor Redundancy
src/health/sensor_redundancy.py - Fault Detector
src/diagnostics/fault_detector.py - Health Monitor
src/health/health_monitor.py - Hybrid AI Detector
src/ai_ml/hybrid_detector.py - RUL Estimator
src/ai_ml/rul_estimator.py - XAI Explainer
src/diagnostics/xai_explainer.py - Maintenance Advisories
src/ai_ml/advisory_engine.py
Mission Operations
- Mission Reliability
src/health/mission_reliability_enhancer.py - Mission Reports
src/reports/report_generator.py - Federated Fleet Learning
src/ai_ml/federated_fleet.py
Operator Interfaces
- FastAPI Service
src/api/server.py - GCS Dashboard
web/js/app.js - Batch Analysis CLI
src/cli.py
Other components
- GCS Operator
- Engine Sensors / FADEC
Connections 29
- Engine Sensors / FADEC → SocketCAN Bridge: sends frames
- SocketCAN Bridge → FastAPI Service: supplies telemetry
- GCS Operator → GCS Dashboard: uses
- GCS Dashboard → FastAPI Service: streams and commands
- FastAPI Service → GCS Dashboard: streams state
- FastAPI Service → Mission Simulator: steps simulator
- Mission Simulator → Telemetry and State: produces frames
- FastAPI Service → Twin Synchronizer: synchronizes frame
- Twin Synchronizer → Engine Physics Models: evaluates models
- FastAPI Service → Sensor Fusion EKF: updates filter
- FastAPI Service → Sensor Redundancy: checks sensor channels
- FastAPI Service → Health Monitor: evaluates health
- FastAPI Service → Fault Detector: detects faults
- FastAPI Service → Hybrid AI Detector: runs AI detection
- FastAPI Service → RUL Estimator: estimates life
- FastAPI Service → XAI Explainer: explains results
- FastAPI Service → Mission Reliability: assesses recovery
- FastAPI Service → Mission Recorder: records mission
- Mission Recorder → Recorded Missions: writes recordings
- FastAPI Service → Mission Reports: generates debrief
- Batch Analysis CLI → Twin Synchronizer: synchronizes frames
- Batch Analysis CLI → Health Monitor: evaluates health
- Batch Analysis CLI → Fault Detector: detects faults
- Batch Analysis CLI → Hybrid AI Detector: runs AI detection
- Batch Analysis CLI → RUL Estimator: estimates life
- Batch Analysis CLI → XAI Explainer: explains results
- Batch Analysis CLI → Maintenance Advisories: generates advisories
- Batch Analysis CLI → Mission Reports: generates debrief
- Federated Fleet Learning → Hybrid AI Detector: shares fleet models