How tudelft-cns-atm/bluesky-gym works
BlueSky-Gym is a Gymnasium-style library of reinforcement-learning environments for air-traffic-management scenarios, backed by the BlueSky simulator. The principal workflow is: a user registers and selects an environment, an agent repeatedly supplies actions through Gymnasium, and the environment advances the simulation and returns observations, rewards, and episode status. The repository also includes training-metric logging and optional wind and uncertainty wrappers. Several environment implementations and wrapper relationships were not excerpted, so their internal links are omitted rather than inferred.
Main entry points: functions.py Navigation Geometry · horizontal_cr_env.py Horizontal Conflict · merge_env.py Traffic Merge · sector_cr_env.py Sector Conflict
Components 18
Gymnasium API
- Gymnasium
- Environment Registration
bluesky_gym/__init__.py
Air Traffic Scenarios
- Descent Scenario
bluesky_gym/envs/descent_env.py - Waypoint Planning
bluesky_gym/envs/plan_waypoint_env.py - Horizontal Conflict
bluesky_gym/envs/horizontal_cr_env.py - Vertical Conflict
bluesky_gym/envs/vertical_cr_env.py - Traffic Merge
bluesky_gym/envs/merge_env.py - Sector Conflict
bluesky_gym/envs/sector_cr_env.py - Static Obstacles
bluesky_gym/envs/static_obstacle_env.py
Shared Environment Logic
- Navigation Geometry
bluesky_gym/envs/common/functions.py - Polygon Generation
bluesky_gym/envs/common/polygon_generator.py - Dummy Screen
bluesky_gym/envs/common/screen_dummy.py - Wind Wrapper
bluesky_gym/wrappers/wind.py - Uncertainty Wrapper
bluesky_gym/wrappers/uncertainty.py
RL Support
- Training CSV Logger
bluesky_gym/utils/logger.py
Other components
- Environment User
- RL Agent
- BlueSky Simulator
Connections 24
- Environment User → Environment Registration: registers
README.md - Environment User → Gymnasium: selects environment
README.md - Environment Registration → Gymnasium: registers environments
bluesky_gym/__init__.py - Gymnasium → Descent Scenario: creates
- Gymnasium → Waypoint Planning: creates
- Gymnasium → Horizontal Conflict: creates
- Gymnasium → Vertical Conflict: creates
- Gymnasium → Traffic Merge: creates
- Gymnasium → Sector Conflict: creates
- Gymnasium → Static Obstacles: creates
- RL Agent → Gymnasium: steps with actions
README.md - Gymnasium → RL Agent: returns results
README.md - Descent Scenario → BlueSky Simulator: advances simulation
README.md - Waypoint Planning → BlueSky Simulator: advances simulation
README.md - Horizontal Conflict → BlueSky Simulator: advances simulation
bluesky_gym/envs/horizontal_cr_env.py - Vertical Conflict → BlueSky Simulator: commands simulation
bluesky_gym/envs/vertical_cr_env.py - Traffic Merge → BlueSky Simulator: advances simulation
bluesky_gym/envs/merge_env.py - Sector Conflict → BlueSky Simulator: checks airspace
bluesky_gym/envs/sector_cr_env.py - Static Obstacles → BlueSky Simulator: advances simulation
bluesky_gym/envs/static_obstacle_env.py - Horizontal Conflict → Navigation Geometry: uses angle helper
bluesky_gym/envs/horizontal_cr_env.py - Traffic Merge → Navigation Geometry: uses angle helper
bluesky_gym/envs/merge_env.py - Sector Conflict → Navigation Geometry: uses coordinate helpers
bluesky_gym/envs/sector_cr_env.py - Static Obstacles → Navigation Geometry: uses angle helper
bluesky_gym/envs/static_obstacle_env.py - RL Agent → Training CSV Logger: logs training
README.md