How cangel18/lsy_drone_racing works
LSY Autonomous Drone Racing provides Gymnasium race environments, controller implementations, simulation/training workflows, and deployment to Crazyflie hardware. The principal workflow is to load a race configuration, run a controller against a single- or multi-drone environment, and evaluate race progress; deployment substitutes real motion-capture observations and hardware commands. The graph retains the documented simulation-to-real and difficulty/randomization capabilities. Some links are limited to README or source-index evidence because several implementation excerpts are partial.
Main entry points: controller.py Controller interface · real_race_env.py Hardware race env · sim.py Simulation runner · race_core.py Race simulation core
Components 25
Race Environments
- Single-drone env
lsy_drone_racing/envs/drone_race.py - Multi-drone env
lsy_drone_racing/envs/multi_drone_race.py - Race simulation core
lsy_drone_racing/envs/race_core.py - Track randomization
lsy_drone_racing/envs/randomize.py
Control and Learning
- Controller interface
lsy_drone_racing/control/controller.py - Attitude control
lsy_drone_racing/control/attitude_controller.py - MPCC racing
lsy_drone_racing/control/pp_racer_mpccpp.py - RL racing policy
lsy_drone_racing/control/rl_racer.py - RL training
lsy_drone_racing/control/train_rl.py - Racer training
lsy_drone_racing/control/train_rl_racer.py
Real-World Deployment
- Hardware race env
lsy_drone_racing/envs/real_race_env.py - Deployment checks
lsy_drone_racing/utils/checks.py - Crazyflie interface
lsy_drone_racing/utils/crazyflie.py - ROS / mocap access
lsy_drone_racing/utils/ros.py - Deployment viewer
lsy_drone_racing/utils/deploy_viewer.py
Run and Evaluate
- Simulation runner
scripts/sim.py - Evaluation runner
scripts/evaluate.py - Deployment runner
scripts/deploy.py - Multi-drone runner
scripts/multi_sim.py - Multi-drone deployment
scripts/multi_deploy.py - Config and loading
lsy_drone_racing/utils/utils.py
Other components
- Engineer / racer
- Crazyflow simulator
- Crazyflie drone
- Motion capture
Connections 31
- Engineer / racer → Simulation runner: runs simulation
scripts/sim.py - Simulation runner → Config and loading: loads settings
scripts/sim.py - Simulation runner → Single-drone env: runs environment
scripts/sim.py - Simulation runner → Controller interface: loads controller
scripts/sim.py - Evaluation runner → Simulation runner: invokes runs
scripts/evaluate.py - Engineer / racer → Deployment runner: starts deployment
scripts/deploy.py - Deployment runner → Config and loading: loads settings
scripts/deploy.py - Deployment runner → Hardware race env: creates environment
scripts/deploy.py - Deployment runner → Deployment viewer: uses viewer
scripts/deploy.py - Engineer / racer → Multi-drone runner: runs multi-drone
scripts/multi_sim.py - Multi-drone runner → Multi-drone env: runs environment
scripts/multi_sim.py - Multi-drone runner → Controller interface: loads controller
scripts/multi_sim.py - Engineer / racer → Multi-drone deployment: starts deployment
scripts/multi_deploy.py - Multi-drone deployment → Hardware race env: creates environment
scripts/multi_deploy.py - Single-drone env → Race simulation core: inherits core
lsy_drone_racing/envs/drone_race.py - Multi-drone env → Race simulation core: inherits core
lsy_drone_racing/envs/multi_drone_race.py - Race simulation core → Track randomization: builds randomizers
lsy_drone_racing/envs/race_core.py - Attitude control → Controller interface: extends interface
lsy_drone_racing/control/attitude_controller.py - Racer training → RL racing policy: uses policy
lsy_drone_racing/control/train_rl_racer.py - Racer training → Single-drone env: trains in env
lsy_drone_racing/control/train_rl_racer.py - RL training → Race simulation core: trains in core env
lsy_drone_racing/control/train_rl.py - Hardware race env → Deployment checks: validates setup
lsy_drone_racing/envs/real_race_env.py - Hardware race env → Crazyflie interface: commands hardware
lsy_drone_racing/envs/real_race_env.py - Hardware race env → ROS / mocap access: reads track poses
lsy_drone_racing/envs/real_race_env.py - Crazyflie interface → Crazyflie drone: sends setpoints
lsy_drone_racing/utils/crazyflie.py - Crazyflie interface → Motion capture: gets estimates
lsy_drone_racing/utils/crazyflie.py - ROS / mocap access → Motion capture: reads poses
lsy_drone_racing/utils/ros.py - Race simulation core → Crazyflow simulator: wraps simulation
README.md - RL training → Controller interface: trains controller
- MPCC racing → Controller interface: implements controller
- RL racing policy → Controller interface: implements controller