How nitin3560/uav-swarm-security works
This repository implements UAV-swarm security simulation and a related ISAC digital-twin synchronisation study. The primary simulation workflow advances swarm dynamics, injects faults and attacks, estimates twin state, detects and attributes anomalies, applies a trust-weighted MPC correction, and tracks the resulting references. A separate Paper 3 workflow replays synthetic or real sensing data and evaluates HOLD/FUSE/SYNC policies. The main workflow is documented in the README; some runner internals and ISAC modules were not sampled, so those links are limited to documented or indexed relationships.
Main entry points: run_study.py Scenario runner · isac_dt_sync_v3.py DeepSense sync · run_matrix.py Seed matrix · trust_mpc.py Trust MPC
Components 21
Swarm simulation
- Scenario runner
run_study.py - Seed matrix
run_matrix.py - Swarm dynamics
env.py - Fault injection
faults.py - Attack injection
attack_injection.py - Swarm trajectory
trajectory.py
Detection and control
- Digital twin
digital_twin.py - Intrusion detector
ids.py - Fault diagnosis
diagnosis.py - Supervisory control
controllers.py - Trust MPC
trust_mpc.py - PID tracking
controllers.py - Security metrics
security_metrics.py
ISAC replay
- EuRoC replay
euroc_replay.py - AERPAW replay
aerpaw_radar_replay.py - Gated radar replay
aerpaw_radar_replay_v2.py - Real-channel replay
real_isac_replay.py
Twin synchronisation
- Synthetic sync study
isac_dt_sync_v2.py - DeepSense sync
isac_dt_sync_v3.py - AERPAW sync
isac_dt_sync_aerpaw.py
Other components
- Study operator
Connections 25
- Study operator → Scenario runner: runs scenario
README.md - Study operator → Seed matrix: runs seeds
README.md - Seed matrix → Scenario runner: orchestrates runs
README.md - Scenario runner → Swarm dynamics: advances state
README.md - Scenario runner → Fault injection: injects faults
README.md - Scenario runner → Attack injection: injects attacks
README.md - Scenario runner → Digital twin: updates estimate
README.md - Scenario runner → Intrusion detector: detects anomalies
README.md - Scenario runner → Fault diagnosis: coordinates diagnosis
- Scenario runner → Supervisory control: selects control
- Scenario runner → Trust MPC: requests correction
README.md - Scenario runner → PID tracking: tracks references
README.md - Scenario runner → Swarm trajectory: uses reference path
- Scenario runner → Security metrics: records outcomes
- Trust MPC → Intrusion detector: reads IDS output
trust_mpc.py - Study operator → EuRoC replay: replays dataset
euroc_replay.py - Study operator → AERPAW replay: replays radar
aerpaw_radar_replay.py - Gated radar replay → AERPAW replay: extends adapter
aerpaw_radar_replay_v2.py - Study operator → Real-channel replay: replays channel
real_isac_replay.py - Study operator → Synthetic sync study: evaluates policies
isac_dt_sync_v2.py - Study operator → DeepSense sync: evaluates real data
isac_dt_sync_v3.py - DeepSense sync → Real-channel replay: loads channel data
isac_dt_sync_v3.py - DeepSense sync → EuRoC replay: uses filter helpers
isac_dt_sync_v3.py - Study operator → AERPAW sync: runs radar sync
isac_dt_sync_aerpaw.py - AERPAW sync → Gated radar replay: consumes radar stream
README.md