How uzh-rpg/agile_narrow_gap_diffsim works
Flightning is a JAX differentiable quadrotor simulator and learning framework for static and moving narrow-gap flight. The main workflow selects a gap and observation mode, trains a BPTT or state-only PPO policy, then loads a checkpoint for rollout evaluation and visualization. The graph preserves the four environment variants, simulation/modeling and sensing layers, policy network, and shared environment utilities. Edges are limited to relationships shown by README statements or the supplied source index; unsampled integration details are omitted.
Main entry points: env_base.py Environment API · train_bptt_gap_crossing.py BPTT training · train_ppo_gap_crossing.py PPO training · evaluate.py Checkpoint evaluation
Components 25
Training and evaluation
- BPTT training
experiments/train_bptt_gap_crossing.py - PPO training
experiments/train_ppo_gap_crossing.py - Checkpoint evaluation
experiments/evaluate.py - Rollout visualization
flightning/envs/visualization/visualization.py - Training configuration
configs/training_configs.yaml - Saved checkpoints
runs
Learning algorithms
- BPTT optimizer
flightning/algos/bptt.py - PPO optimizer
flightning/algos/ppo.py
Gap environments
- Static state task
flightning/envs/static_gap_state_env.py - Static vision task
flightning/envs/static_gap_vision_env.py - Moving state task
flightning/envs/moving_gap_state_env.py - Moving vision task
flightning/envs/moving_gap_vision_env.py - Environment API
flightning/envs/env_base.py - Environment wrappers
flightning/envs/wrappers.py
Simulation and sensing
- Quadrotor dynamics
flightning/objects/quadrotor_simple_obj.py - Extended quadrotor
flightning/objects/quadrotor_obj.py - World geometry
flightning/objects/world_box_obj.py - Double-sphere camera
flightning/sensors/double_sphere_camera.py - Dynamics augmentation
flightning/simulation
Policy and shared runtime
- MLP policy
flightning/modules/mlp.py - Action and observation spaces
flightning/utils/spaces.py - JAX pytree utilities
flightning/utils/pytrees.py - Math utilities
flightning/utils/math.py - Randomization utilities
flightning/utils/random.py
Other components
- Researcher
Connections 34
- Researcher → BPTT training: starts training
README.md - Researcher → PPO training: starts training
README.md - Researcher → Checkpoint evaluation: requests evaluation
README.md - BPTT training → BPTT optimizer: invokes
experiments/train_bptt_gap_crossing.py - PPO training → PPO optimizer: invokes
experiments/train_ppo_gap_crossing.py - BPTT training → Environment API: creates task
experiments/train_bptt_gap_crossing.py - PPO training → Environment API: creates task
experiments/train_ppo_gap_crossing.py - BPTT training → Environment wrappers: uses
experiments/train_bptt_gap_crossing.py - PPO training → Environment wrappers: uses
experiments/train_ppo_gap_crossing.py - BPTT training → MLP policy: builds policy
experiments/train_bptt_gap_crossing.py - PPO optimizer → MLP policy: uses policy
flightning/algos/ppo.py - BPTT optimizer → Environment API: rolls out
flightning/algos/bptt.py - PPO optimizer → Environment API: steps environment
flightning/algos/ppo.py - Checkpoint evaluation → BPTT training: loads policy
experiments/evaluate.py - Checkpoint evaluation → PPO training: loads policy
experiments/evaluate.py - Checkpoint evaluation → Rollout visualization: renders results
experiments/evaluate.py - BPTT training → Saved checkpoints: saves checkpoint
README.md - Checkpoint evaluation → Saved checkpoints: loads checkpoint
README.md - BPTT training → Training configuration: reads settings
README.md - PPO training → Training configuration: reads settings
README.md - Environment API → Action and observation spaces: defines spaces
flightning/envs/env_base.py - Environment API → JAX pytree utilities: uses state trees
flightning/envs/env_base.py - Static state task → Environment API: implements API
flightning/envs/static_gap_state_env.py - Static vision task → Environment API: implements API
flightning/envs/static_gap_vision_env.py - Moving state task → Environment API: implements API
flightning/envs/moving_gap_state_env.py - Moving vision task → Environment API: implements API
flightning/envs/moving_gap_vision_env.py - Static state task → Quadrotor dynamics: uses dynamics
flightning/envs/static_gap_state_env.py - Moving state task → Quadrotor dynamics: uses dynamics
flightning/envs/moving_gap_state_env.py - Static vision task → Double-sphere camera: uses sensing
flightning/envs/static_gap_vision_env.py - Moving vision task → Double-sphere camera: uses sensing
flightning/envs/moving_gap_vision_env.py - Extended quadrotor → Quadrotor dynamics: extends dynamics
flightning/objects/quadrotor_obj.py - Static state task → Math utilities: uses geometry math
flightning/envs/static_gap_state_env.py - Static state task → Randomization utilities: randomizes starts
flightning/envs/static_gap_state_env.py - Environment wrappers → Environment API: wraps
flightning/envs/wrappers.py