# ifradnbl/yeah-science- architecture

> Architecture diagram of the GitHub repository ifradnbl/yeah-science-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ifradnbl/yeah-science-
- Repository: https://github.com/ifradnbl/yeah-science-

## Overview

This repository is a loopback ground station paired with a separate software rover simulator. The main workflow is to operate the station UI, send drive commands over UDP, simulate rover motion, and display returned telemetry. The graph also preserves the documented field view, session notes, and event/connection displays. UI component interactions are described at a feature level because their QML source was not sampled; links between runtime modules follow the excerpts and README.

Main entry points: [`qml/Main.qml`](https://github.com/ifradnbl/yeah-science-/blob/main/qml/Main.qml) (Station Window), [`app/controller.py`](https://github.com/ifradnbl/yeah-science-/blob/main/app/controller.py) (Station Coordinator), [`simulator/__main__.py`](https://github.com/ifradnbl/yeah-science-/blob/main/simulator/__main__.py) (Simulator Loop), [`app/__main__.py`](https://github.com/ifradnbl/yeah-science-/blob/main/app/__main__.py) (Station Startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Station UI"]
  node_window["Station Window<br/>[Main.qml]"]
  node_drive["Drive Controls<br/>[DrivePad.qml]"]
  node_settings["Settings Panel<br/>[SettingsPanel.qml]"]
  node_events["Event Log<br/>[EventLog.qml]"]
  node_metrics["Telemetry Cards<br/>[Metric.qml]"]
  node_field["Rover Field View<br/>[RoverView.qml]"]
  node_notes["Session Notes<br/>[Panel.qml]"]
end

subgraph group_station["Station Runtime"]
  node_entry["Station Startup<br/>[__main__.py]"]
  node_stationcore["Station Coordinator<br/>[controller.py]"]
  node_config["Configuration<br/>[config.py]"]
  node_telemetry["Telemetry Store<br/>[telemetry.py]"]
end

subgraph group_link["Link Protocol"]
  node_udp["UDP Transport<br/>[udp.py]"]
  node_packets["Packet Validation<br/>[packets.py]"]
end

subgraph group_sim["Rover Simulator"]
  node_simentry["Simulator Loop<br/>[__main__.py]"]
  node_rover["Rover Model<br/>[rover.py]"]
end

node_operator(("Operator"))

node_operator -->|"operates"| node_window
node_entry -->|"loads"| node_config
node_entry -->|"creates"| node_stationcore
node_entry -->|"loads"| node_window
node_window -->|"presents"| node_drive
node_window -->|"presents"| node_settings
node_window -->|"presents"| node_events
node_window -->|"presents"| node_metrics
node_window -->|"presents"| node_field
node_window -->|"presents"| node_notes
node_drive -->|"requests drive"| node_stationcore
node_stationcore -->|"sends and receives"| node_udp
node_stationcore -->|"encodes and decodes"| node_packets
node_stationcore -->|"updates"| node_telemetry
node_telemetry -->|"supplies values"| node_metrics
node_telemetry -->|"supplies pose"| node_field
node_stationcore -->|"logs status"| node_events
node_simentry -->|"loads"| node_config
node_simentry -->|"encodes and decodes"| node_packets
node_simentry -->|"commands and steps"| node_rover
node_stationcore -->|"exchanges UDP datagrams"| node_simentry

click node_window "https://github.com/ifradnbl/yeah-science-/blob/main/qml/Main.qml"
click node_drive "https://github.com/ifradnbl/yeah-science-/blob/main/qml/DrivePad.qml"
click node_settings "https://github.com/ifradnbl/yeah-science-/blob/main/qml/SettingsPanel.qml"
click node_events "https://github.com/ifradnbl/yeah-science-/blob/main/qml/EventLog.qml"
click node_metrics "https://github.com/ifradnbl/yeah-science-/blob/main/qml/Metric.qml"
click node_field "https://github.com/ifradnbl/yeah-science-/blob/main/qml/RoverView.qml"
click node_notes "https://github.com/ifradnbl/yeah-science-/blob/main/qml/Panel.qml"
click node_entry "https://github.com/ifradnbl/yeah-science-/blob/main/app/__main__.py"
click node_stationcore "https://github.com/ifradnbl/yeah-science-/blob/main/app/controller.py"
click node_config "https://github.com/ifradnbl/yeah-science-/blob/main/app/config.py"
click node_telemetry "https://github.com/ifradnbl/yeah-science-/blob/main/app/telemetry.py"
click node_udp "https://github.com/ifradnbl/yeah-science-/blob/main/link/udp.py"
click node_packets "https://github.com/ifradnbl/yeah-science-/blob/main/link/packets.py"
click node_simentry "https://github.com/ifradnbl/yeah-science-/blob/main/simulator/__main__.py"
click node_rover "https://github.com/ifradnbl/yeah-science-/blob/main/simulator/rover.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_window,node_drive,node_settings,node_events,node_metrics,node_field,node_notes toneBlue
class node_entry,node_stationcore,node_config,node_telemetry toneAmber
class node_udp,node_packets toneMint
class node_simentry,node_rover toneRose
class node_operator toneIndigo
```

## Components

### Station UI

- [Station Window](https://github.com/ifradnbl/yeah-science-/blob/main/qml/Main.qml): `qml/Main.qml`
- [Drive Controls](https://github.com/ifradnbl/yeah-science-/blob/main/qml/DrivePad.qml): `qml/DrivePad.qml`
- [Settings Panel](https://github.com/ifradnbl/yeah-science-/blob/main/qml/SettingsPanel.qml): `qml/SettingsPanel.qml`
- [Event Log](https://github.com/ifradnbl/yeah-science-/blob/main/qml/EventLog.qml): `qml/EventLog.qml`
- [Telemetry Cards](https://github.com/ifradnbl/yeah-science-/blob/main/qml/Metric.qml): `qml/Metric.qml`
- [Rover Field View](https://github.com/ifradnbl/yeah-science-/blob/main/qml/RoverView.qml): `qml/RoverView.qml`
- [Session Notes](https://github.com/ifradnbl/yeah-science-/blob/main/qml/Panel.qml): `qml/Panel.qml`

### Station Runtime

- [Station Startup](https://github.com/ifradnbl/yeah-science-/blob/main/app/__main__.py): `app/__main__.py`
- [Station Coordinator](https://github.com/ifradnbl/yeah-science-/blob/main/app/controller.py): `app/controller.py`
- [Configuration](https://github.com/ifradnbl/yeah-science-/blob/main/app/config.py): `app/config.py`
- [Telemetry Store](https://github.com/ifradnbl/yeah-science-/blob/main/app/telemetry.py): `app/telemetry.py`

### Link Protocol

- [UDP Transport](https://github.com/ifradnbl/yeah-science-/blob/main/link/udp.py): `link/udp.py`
- [Packet Validation](https://github.com/ifradnbl/yeah-science-/blob/main/link/packets.py): `link/packets.py`

### Rover Simulator

- [Simulator Loop](https://github.com/ifradnbl/yeah-science-/blob/main/simulator/__main__.py): `simulator/__main__.py`
- [Rover Model](https://github.com/ifradnbl/yeah-science-/blob/main/simulator/rover.py): `simulator/rover.py`

### Other components

- **Operator**

## Connections

- Operator → Station Window: operates (evidence: `README.md`)
- Station Startup → Configuration: loads (evidence: `app/__main__.py`)
- Station Startup → Station Coordinator: creates (evidence: `app/__main__.py`)
- Station Startup → Station Window: loads (evidence: `app/__main__.py`)
- Station Window → Drive Controls: presents (evidence: `README.md`)
- Station Window → Settings Panel: presents (evidence: `README.md`)
- Station Window → Event Log: presents (evidence: `README.md`)
- Station Window → Telemetry Cards: presents (evidence: `README.md`)
- Station Window → Rover Field View: presents (evidence: `README.md`)
- Station Window → Session Notes: presents (evidence: `README.md`)
- Drive Controls → Station Coordinator: requests drive (evidence: `README.md`)
- Station Coordinator → UDP Transport: sends and receives (evidence: `app/controller.py`)
- Station Coordinator → Packet Validation: encodes and decodes (evidence: `app/controller.py`)
- Station Coordinator → Telemetry Store: updates (evidence: `app/controller.py`)
- Telemetry Store → Telemetry Cards: supplies values (evidence: `README.md`)
- Telemetry Store → Rover Field View: supplies pose (evidence: `README.md`)
- Station Coordinator → Event Log: logs status (evidence: `app/controller.py`)
- Simulator Loop → Configuration: loads (evidence: `simulator/__main__.py`)
- Simulator Loop → Packet Validation: encodes and decodes (evidence: `simulator/__main__.py`)
- Simulator Loop → Rover Model: commands and steps (evidence: `simulator/__main__.py`)
- Station Coordinator → Simulator Loop: exchanges UDP datagrams (evidence: `README.md`)
