How malkudkarnitya-creator/sih26054_phm_v2 works
This UAV propulsion-health monitoring product ingests flight telemetry, estimates engine state, compares it with a physics model, classifies faults, and derives mission guidance. Users interact through a React command dashboard and a Streamlit ground-control dashboard; the FastAPI backend also exposes a persistent digital twin with telemetry, history, fleet, mission, and what-if operations. The graph emphasizes relationships visible in excerpts or the source index; unsampled UI and backend subsystems are represented at their existing directory paths, with uncertain links omitted.
Main entry points: dashboard.py Ground-control dashboard · main.py FastAPI endpoints · experiment_runner/runner.py Experiment runner · pipeline/runner.py Analysis pipeline
Components 26
Operator interfaces
- React command app
frontend/src/App.jsx - Mission dashboard
frontend/src/pages/Dashboard.jsx - Mission state
frontend/src/hooks/useMission.js - Twin interface
frontend/src/v2 - Ground-control dashboard
dashboard.py - PHM API client
frontend/src/api/phmApi.js
API and twin
- FastAPI endpoints
backend/api/main.py - API data models
backend/api/models.py - Twin routes
backend/twin/router.py - Twin service
backend/twin/service.py - Twin state models
backend/twin/model.py - Twin request schemas
backend/twin/schemas.py - Twin SQLite history
backend/twin/service.py
Health analysis
- EKF estimator
src/uav_health/ekf/ekf.py - Engine physics model
src/uav_health/physics_model/engine_model.py - Residual generator
src/uav_health/residual_generator.py - Fault classifier
src/uav_health/fault_classifier/classifier.py
Mission operations
- Mission decision
src/uav_health/mission_decision/decision.py - Analysis pipeline
src/uav_health/pipeline/runner.py - Replay engine
src/uav_health/replay_engine/replay.py - Experiment runner
src/uav_health/experiment_runner/runner.py - Validation metrics
src/uav_health/validation_metrics/metrics.py - Flight data loading
src/uav_health/flight_data - Fault injection
src/uav_health/fault_injection - Digital twin model
src/uav_health/digital_twin/digital_twin.py
Other components
- Operator
Connections 45
- Operator → React command app: uses
frontend/src/App.jsx - React command app → Mission dashboard: routes to
frontend/src/App.jsx - React command app → Twin interface: routes to
- Mission dashboard → Mission state: reads
frontend/src/pages/Dashboard.jsx - Mission state → PHM API client: loads data
- Operator → Ground-control dashboard: uses
dashboard.py - PHM API client → FastAPI endpoints: requests
- FastAPI endpoints → API data models: validates with
backend/api/main.py - FastAPI endpoints → EKF estimator: estimates
backend/api/main.py - FastAPI endpoints → Engine physics model: predicts with
backend/api/main.py - FastAPI endpoints → Residual generator: calculates
backend/api/main.py - FastAPI endpoints → Fault classifier: classifies with
backend/api/main.py - FastAPI endpoints → Mission decision: decides with
backend/api/main.py - FastAPI endpoints → Twin routes: registers
backend/api/main.py - Twin routes → Twin service: dispatches to
backend/twin/router.py - Twin routes → Twin request schemas: validates with
backend/twin/router.py - Twin service → Twin state models: updates
backend/twin/service.py - Twin service → Twin SQLite history: persists
backend/twin/service.py - Analysis pipeline → Flight data loading: loads
src/uav_health/pipeline/runner.py - Analysis pipeline → EKF estimator: uses
src/uav_health/pipeline/runner.py - Analysis pipeline → Engine physics model: uses
src/uav_health/pipeline/runner.py - Analysis pipeline → Residual generator: uses
src/uav_health/pipeline/runner.py - Analysis pipeline → Fault classifier: uses
src/uav_health/pipeline/runner.py - Analysis pipeline → Mission decision: uses
src/uav_health/pipeline/runner.py - Replay engine → Flight data loading: uses
src/uav_health/replay_engine/replay.py - Replay engine → EKF estimator: uses
src/uav_health/replay_engine/replay.py - Replay engine → Engine physics model: uses
src/uav_health/replay_engine/replay.py - Replay engine → Residual generator: uses
src/uav_health/replay_engine/replay.py - Replay engine → Fault classifier: uses
src/uav_health/replay_engine/replay.py - Replay engine → Mission decision: uses
src/uav_health/replay_engine/replay.py - Experiment runner → EKF estimator: uses
src/uav_health/experiment_runner/runner.py - Experiment runner → Fault classifier: uses
src/uav_health/experiment_runner/runner.py - Experiment runner → Fault injection: uses
src/uav_health/experiment_runner/runner.py - Experiment runner → Mission decision: uses
src/uav_health/experiment_runner/runner.py - Experiment runner → Engine physics model: uses
src/uav_health/experiment_runner/runner.py - Experiment runner → Residual generator: uses
src/uav_health/experiment_runner/runner.py - Experiment runner → Validation metrics: measures with
src/uav_health/experiment_runner/runner.py - Ground-control dashboard → Experiment runner: runs
dashboard.py - Ground-control dashboard → EKF estimator: uses
dashboard.py - Ground-control dashboard → Fault classifier: uses
dashboard.py - Ground-control dashboard → Fault injection: uses
dashboard.py - Ground-control dashboard → Mission decision: uses
dashboard.py - Ground-control dashboard → Engine physics model: uses
dashboard.py - Ground-control dashboard → Residual generator: uses
dashboard.py - Ground-control dashboard → Validation metrics: uses
dashboard.py