# tudelft-cns-atm/bluesky architecture

> Architecture diagram of the GitHub repository tudelft-cns-atm/bluesky, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tudelft-cns-atm/bluesky
- Repository: https://github.com/tudelft-cns-atm/bluesky

## Overview

BlueSky is an open air-traffic-management simulator for research, visualization, and traffic-flow analysis. Users enter commands in a console or run timestamped scenario files; the command stack delivers simulation actions, and the simulation advances aircraft traffic using performance, navigation, and separation logic. Results can be viewed through a GUI or console, while client/server networking supports distributed operation. Plugins extend simulation and command behavior. The README documents these capabilities; sampled source and the source index support startup, command, plugin, and networking links, but many domain internals were not excerpted, so some documented links are cited to the README.

Main entry points: [`bluesky/traffic/traffic.py`](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/traffic/traffic.py) (Aircraft Traffic), [`bluesky/simulation/simulation.py`](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/simulation/simulation.py) (Simulation Engine), [`bluesky/stack/cmdparser.py`](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/stack/cmdparser.py) (Command Stack), [`bluesky/core/plugin.py`](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/core/plugin.py) (Plugin System)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User Interaction"]
  node_stack["Command Stack<br/>[cmdparser.py]"]
  node_arguments["Command Arguments<br/>[argparser.py]"]
  node_clientstack["Client Commands<br/>[clientstack.py]"]
  node_visualization["Visualization"]
  node_pygame["Pygame Display<br/>[screen.py]"]
  node_console["Console UI<br/>[consoleui.py]"]
end

subgraph group_simulation["Simulation Domain"]
  node_simulation["Simulation Engine<br/>[simulation.py]"]
  node_traffic["Aircraft Traffic<br/>[traffic.py]"]
  node_routes["Flight Routes<br/>[route.py]"]
  node_performance["Aircraft Performance"]
  node_separation["Conflict Detection"]
  node_resolution["Conflict Resolution<br/>[resolution.py]"]
end

subgraph group_extensions["Extensions and Data"]
  node_navigation[("Navigation Database<br/>[navdatabase.py]")]
  node_aero["Aero Calculations<br/>[aero.py]"]
  node_plugins["Plugin System<br/>[plugin.py]"]
end

subgraph group_runtime["Runtime Infrastructure"]
  node_settings["Configuration<br/>[settings.py]"]
  node_signals["Signals<br/>[signal.py]"]
  node_funcobject["Callback Wrapper<br/>[funcobject.py]"]
end

subgraph group_networking["Distributed Operation"]
  node_publisher["State Publisher<br/>[publisher.py]"]
  node_subscriber["State Subscriber<br/>[subscriber.py]"]
  node_networknode["Network Node<br/>[node.py]"]
  node_server["Simulation Server<br/>[server.py]"]
end

node_user(("Operator"))
node_scenarios["Scenario Files"]

node_user -->|"enters commands"| node_stack
node_scenarios -->|"provides commands"| node_stack
node_stack -->|"parses arguments"| node_arguments
node_clientstack -->|"dispatches commands"| node_stack
node_simulation -->|"uses sim stack"| node_stack
node_simulation -.->|"advances traffic"| node_traffic
node_traffic -->|"uses routes"| node_routes
node_traffic -->|"models performance"| node_performance
node_traffic -->|"checks conflicts"| node_separation
node_separation -->|"resolves conflicts"| node_resolution
node_traffic -->|"uses navigation data"| node_navigation
node_traffic -->|"uses aero functions"| node_aero
node_user -->|"views traffic"| node_visualization
node_user -->|"views traffic"| node_pygame
node_user -->|"enters commands"| node_console
node_plugins -->|"adds commands"| node_stack
node_plugins -->|"reads configuration"| node_settings
node_plugins -->|"extends simulation"| node_simulation
node_simulation -->|"publishes state"| node_publisher
node_subscriber -->|"subscribes to state"| node_publisher
node_networknode -->|"processes commands"| node_clientstack
node_server -->|"manages nodes"| node_networknode
node_server -->|"starts simulation nodes"| node_simulation
node_signals -->|"wraps callbacks"| node_funcobject
node_simulation -->|"uses signals"| node_signals
node_visualization -.->|"receives state"| node_subscriber

click node_stack "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/stack/cmdparser.py"
click node_arguments "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/stack/argparser.py"
click node_clientstack "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/stack/clientstack.py"
click node_simulation "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/simulation/simulation.py"
click node_traffic "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/traffic/traffic.py"
click node_routes "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/traffic/route.py"
click node_performance "https://github.com/tudelft-cns-atm/bluesky/tree/master/bluesky/traffic/performance"
click node_separation "https://github.com/tudelft-cns-atm/bluesky/tree/master/bluesky/traffic/asas"
click node_resolution "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/traffic/asas/resolution.py"
click node_navigation "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/navdatabase/navdatabase.py"
click node_aero "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/tools/aero.py"
click node_plugins "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/core/plugin.py"
click node_settings "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/settings.py"
click node_signals "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/core/signal.py"
click node_funcobject "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/core/funcobject.py"
click node_publisher "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/network/publisher.py"
click node_subscriber "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/network/subscriber.py"
click node_networknode "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/network/node.py"
click node_server "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/network/server.py"
click node_visualization "https://github.com/tudelft-cns-atm/bluesky/tree/master/bluesky/ui/qtgl"
click node_pygame "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/ui/pygame/screen.py"
click node_console "https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/ui/console/consoleui.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_stack,node_arguments,node_clientstack,node_visualization,node_pygame,node_console toneBlue
class node_simulation,node_traffic,node_routes,node_performance,node_separation,node_resolution toneAmber
class node_navigation,node_aero,node_plugins toneMint
class node_settings,node_signals,node_funcobject toneRose
class node_publisher,node_subscriber,node_networknode,node_server,node_user,node_scenarios toneIndigo
```

## Components

### User Interaction

- [Command Stack](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/stack/cmdparser.py): `bluesky/stack/cmdparser.py`
- [Command Arguments](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/stack/argparser.py): `bluesky/stack/argparser.py`
- [Client Commands](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/stack/clientstack.py): `bluesky/stack/clientstack.py`
- [Visualization](https://github.com/tudelft-cns-atm/bluesky/tree/master/bluesky/ui/qtgl): `bluesky/ui/qtgl`
- [Pygame Display](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/ui/pygame/screen.py): `bluesky/ui/pygame/screen.py`
- [Console UI](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/ui/console/consoleui.py): `bluesky/ui/console/consoleui.py`

### Simulation Domain

- [Simulation Engine](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/simulation/simulation.py): `bluesky/simulation/simulation.py`
- [Aircraft Traffic](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/traffic/traffic.py): `bluesky/traffic/traffic.py`
- [Flight Routes](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/traffic/route.py): `bluesky/traffic/route.py`
- [Aircraft Performance](https://github.com/tudelft-cns-atm/bluesky/tree/master/bluesky/traffic/performance): `bluesky/traffic/performance`
- [Conflict Detection](https://github.com/tudelft-cns-atm/bluesky/tree/master/bluesky/traffic/asas): `bluesky/traffic/asas`
- [Conflict Resolution](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/traffic/asas/resolution.py): `bluesky/traffic/asas/resolution.py`

### Extensions and Data

- [Navigation Database](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/navdatabase/navdatabase.py): `bluesky/navdatabase/navdatabase.py`
- [Aero Calculations](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/tools/aero.py): `bluesky/tools/aero.py`
- [Plugin System](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/core/plugin.py): `bluesky/core/plugin.py`

### Runtime Infrastructure

- [Configuration](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/settings.py): `bluesky/settings.py`
- [Signals](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/core/signal.py): `bluesky/core/signal.py`
- [Callback Wrapper](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/core/funcobject.py): `bluesky/core/funcobject.py`

### Distributed Operation

- [State Publisher](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/network/publisher.py): `bluesky/network/publisher.py`
- [State Subscriber](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/network/subscriber.py): `bluesky/network/subscriber.py`
- [Network Node](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/network/node.py): `bluesky/network/node.py`
- [Simulation Server](https://github.com/tudelft-cns-atm/bluesky/blob/master/bluesky/network/server.py): `bluesky/network/server.py`

### Other components

- **Operator**
- **Scenario Files**

## Connections

- Operator → Command Stack: enters commands
- Scenario Files → Command Stack: provides commands
- Command Stack → Command Arguments: parses arguments (evidence: `bluesky/stack/cmdparser.py`)
- Client Commands → Command Stack: dispatches commands (evidence: `bluesky/stack/clientstack.py`)
- Simulation Engine → Command Stack: uses sim stack (evidence: `bluesky/simulation/simulation.py`)
- Simulation Engine → Aircraft Traffic: advances traffic
- Aircraft Traffic → Flight Routes: uses routes (evidence: `bluesky/traffic/route.py`)
- Aircraft Traffic → Aircraft Performance: models performance
- Aircraft Traffic → Conflict Detection: checks conflicts
- Conflict Detection → Conflict Resolution: resolves conflicts
- Aircraft Traffic → Navigation Database: uses navigation data
- Aircraft Traffic → Aero Calculations: uses aero functions
- Operator → Visualization: views traffic
- Operator → Pygame Display: views traffic
- Operator → Console UI: enters commands
- Plugin System → Command Stack: adds commands (evidence: `bluesky/core/plugin.py`)
- Plugin System → Configuration: reads configuration (evidence: `bluesky/core/plugin.py`)
- Plugin System → Simulation Engine: extends simulation (evidence: `bluesky/simulation/simulation.py`)
- Simulation Engine → State Publisher: publishes state (evidence: `bluesky/simulation/simulation.py`)
- State Subscriber → State Publisher: subscribes to state (evidence: `bluesky/network/subscriber.py`)
- Network Node → Client Commands: processes commands (evidence: `bluesky/network/client.py`)
- Simulation Server → Network Node: manages nodes (evidence: `bluesky/network/server.py`)
- Simulation Server → Simulation Engine: starts simulation nodes (evidence: `bluesky/network/server.py`)
- Signals → Callback Wrapper: wraps callbacks (evidence: `bluesky/core/signal.py`)
- Simulation Engine → Signals: uses signals (evidence: `bluesky/simulation/simulation.py`)
- Visualization → State Subscriber: receives state
