How nitin3560/uav-trajectory-tracking works
This repository is a UAV trajectory-tracking controller comparison study. Its main workflow runs a seeded simulation, applies trajectories and fault/disturbance scenarios, executes a selected controller, and evaluates tracking and recovery. The README also describes batch comparisons, per-seed telemetry, plots, and summary metrics. The graph emphasizes the primary src/ runtime; review-bundle and legacy controller copies are retained as distinct code where identified by the source index. Some links are documented or index-supported rather than verified from complete runtime excerpts.
Main entry points: run_one.py Seeded simulation · pid_core.py PID core · pid.py PID controller · pid_agentic.py Agentic PID hybrid
Components 18
Simulation inputs
- Seeded simulation
src/run_one.py - Drone environment
src/env_factory.py - Trajectory definitions
src/trajectories.py - Fault injection
src/faults/fault_injector.py - Wind and failures
src/disturbances.py
Control strategies
- Open-loop controller
src/controllers/openloop.py - PID controller
src/controllers/pid.py - Agentic PID hybrid
src/controllers/pid_agentic.py - PID supervisor
src/controllers/agentic_supervisor.py - PID core
src/control_core/pid_core.py
Evaluation outputs
- Tracking metrics
src/metrics.py - CSV evaluation
src/eval/evaluate_csv.py - Per-seed telemetry
src/run_one.py
Alternate implementations
- Legacy PID tracker
src/controllers/legacy/pid_tracker.py - Review PID hybrid
review_bundle/controllers/pid_agentic.py - Case-study PID hybrid
case study1/src/controllers/pid_agentic.py - Case-study review hybrid
case study1/review_bundle/controllers/pid_agentic.py
Other components
- Study runner
Connections 18
- Study runner → Seeded simulation: runs
README.md - Seeded simulation → Drone environment: creates
src/run_one.py - Seeded simulation → Trajectory definitions: uses
src/run_one.py - Seeded simulation → Fault injection: uses
src/run_one.py - Seeded simulation → Wind and failures: uses
src/run_one.py - Seeded simulation → Open-loop controller: dispatches
src/run_one.py - Seeded simulation → PID controller: dispatches
src/run_one.py - Seeded simulation → Agentic PID hybrid: dispatches
src/run_one.py - Seeded simulation → PID supervisor: consults
src/run_one.py - Agentic PID hybrid → PID core: uses
src/controllers/pid_agentic.py - PID controller → PID core: uses
src/controllers/pid.py - Seeded simulation → Tracking metrics: computes
src/run_one.py - Seeded simulation → Per-seed telemetry: writes
README.md - Per-seed telemetry → CSV evaluation: evaluated by
README.md - Seeded simulation → Legacy PID tracker: available via
- Review PID hybrid → PID core: uses
review_bundle/controllers/pid_agentic.py - Case-study PID hybrid → PID core: uses
case study1/src/controllers/pid_agentic.py - Case-study review hybrid → PID core: uses
case study1/review_bundle/controllers/pid_agentic.py