How nitin3560/uav-autonomy-research-suite works
The repository is a three-part UAV autonomy research suite: PyBullet fault-aware formation control, learned relay coordination, and a lightweight fault-study runner. The main user workflow is to configure and run simulations or experiments, inject or model faults, then measure and compare outcomes. Case Study 1 has a sampled runner-to-components path; Case Studies 2 and 3 are represented at subsystem level where implementation wiring was not sampled. README capability statements support their high-level roles, not unshown calls.
Main entry points: run_one.py Flight Runner · run_study.py Study Runner · evaluation Relay Evaluation · pybullet_sim_node.py ROS Simulation Node
Components 29
Fault-Aware Flight
- Flight Runner
Case Studies/Case Study 1 Flight Control/code/src/run_one.py - PyBullet Environment
Case Studies/Case Study 1 Flight Control/code/src/env_factory.py - Formation Trajectories
Case Studies/Case Study 1 Flight Control/code/src/trajectories.py - Disturbance Model
Case Studies/Case Study 1 Flight Control/code/src/disturbances.py - Fault Injection
Case Studies/Case Study 1 Flight Control/code/src/faults/fault_injector.py - Flight Controllers
Case Studies/Case Study 1 Flight Control/code/src/controllers - PID Core
Case Studies/Case Study 1 Flight Control/code/src/control_core/pid_core.py - Failure Supervisor
Case Studies/Case Study 1 Flight Control/code/src/controllers/agentic_supervisor.py - Failure-Aware Logic
Case Studies/Case Study 1 Flight Control/code/src/failure_aware.py - Flight Metrics
Case Studies/Case Study 1 Flight Control/code/src/metrics.py
Relay Coordination
- Task and Network Environment
Case Studies/Case Study 2 Relay Coordination/code/envs/lawn_task_comm_env.py - MARL Policy
Case Studies/Case Study 2 Relay Coordination/code/agents/marl_policy.py - Policy Training
Case Studies/Case Study 2 Relay Coordination/code/training - Coordination Baselines
Case Studies/Case Study 2 Relay Coordination/code/baselines - Relay Evaluation
Case Studies/Case Study 2 Relay Coordination/code/evaluation - Results Analysis
Case Studies/Case Study 2 Relay Coordination/code/analysis
Lightweight Fault Study
- Study Runner
Case Studies/Case Study 3 Fault Study/code/run_study.py - Scenario Matrix
Case Studies/Case Study 3 Fault Study/code/run_matrix.py - Study Environment
Case Studies/Case Study 3 Fault Study/code/env.py - Study Fault Models
Case Studies/Case Study 3 Fault Study/code/faults.py - Study Controllers
Case Studies/Case Study 3 Fault Study/code/controllers.py - Fault Diagnosis
Case Studies/Case Study 3 Fault Study/code/diagnosis.py - State Estimation
Case Studies/Case Study 3 Fault Study/code/estimation.py - Study Metrics
Case Studies/Case Study 3 Fault Study/code/metrics.py
ROS 2 Bridge
- ROS Simulation Node
Case Studies/Case Study 1 Flight Control/ROS 2 Bridge/src/failure_aware_swarm_ros2/failure_aware_swarm_ros2/pybullet_sim_node.py
Other components
- Experimenter
- Relay Researcher
- Study Researcher
- ROS 2 Operator
Connections 29
- Experimenter → Flight Runner: runs
- Flight Runner → PyBullet Environment: creates
Case Studies/Case Study 1 Flight Control/code/src/run_one.py - Flight Runner → Formation Trajectories: uses
Case Studies/Case Study 1 Flight Control/code/src/run_one.py - Flight Runner → Disturbance Model: uses
Case Studies/Case Study 1 Flight Control/code/src/run_one.py - Flight Runner → Fault Injection: uses
Case Studies/Case Study 1 Flight Control/code/src/run_one.py - Flight Runner → Flight Controllers: selects
Case Studies/Case Study 1 Flight Control/code/src/run_one.py - Flight Runner → Failure Supervisor: uses
Case Studies/Case Study 1 Flight Control/code/src/run_one.py - Flight Runner → Failure-Aware Logic: uses
Case Studies/Case Study 1 Flight Control/code/src/run_one.py - Flight Runner → Flight Metrics: uses
Case Studies/Case Study 1 Flight Control/code/src/run_one.py - PyBullet Environment → Formation Trajectories: gets references
Case Studies/Case Study 1 Flight Control/code/src/env_factory.py - Flight Controllers → PID Core: uses
Case Studies/Case Study 1 Flight Control/code/src/controllers/pid.py - ROS 2 Operator → ROS Simulation Node: launches
- ROS Simulation Node → PyBullet Environment: wraps simulation
Case Studies/Case Study 1 Flight Control/ROS 2 Bridge/src/failure_aware_swarm_ros2/failure_aware_swarm_ros2/pybullet_sim_node.py - ROS Simulation Node → Disturbance Model: uses
Case Studies/Case Study 1 Flight Control/ROS 2 Bridge/src/failure_aware_swarm_ros2/failure_aware_swarm_ros2/pybullet_sim_node.py - ROS Simulation Node → Fault Injection: uses
- Relay Researcher → Policy Training: trains policies
- Policy Training → MARL Policy: trains
- Relay Researcher → Relay Evaluation: evaluates
- Relay Evaluation → Task and Network Environment: evaluates policies
- Relay Evaluation → Coordination Baselines: compares
- Relay Evaluation → Results Analysis: summarizes results
- Study Researcher → Study Runner: runs studies
- Study Researcher → Scenario Matrix: runs sweeps
- Study Runner → Study Environment: simulates scenarios
- Study Runner → Study Fault Models: injects faults
- Study Runner → Study Controllers: compares controllers
- Study Runner → Fault Diagnosis: supports ablations
- Study Runner → State Estimation: supports ablations
- Study Runner → Study Metrics: measures outcomes