# ryerson-rocketry/rocket-antenna-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/ryerson-rocketry/rocket-antenna-tracker
- Repository: https://github.com/ryerson-rocketry/rocket-antenna-tracker

## Overview

This repository is a 2-axis rocket-tracking antenna prototype, with separate GUI, Arduino, and console implementations rather than one demonstrated end-to-end runtime. The visible workflows calculate azimuth and elevation from ground-station and rocket coordinates; the Arduino variant maps those angles to two servos. Python scripts can send replay or generated coordinates over UDP, but no receiver or connection to the GUI/controller is shown. The README describes telemetry, manual overrides, and machine-learning prediction, but prediction and live integration are not present in the sampled implementation.

Main entry points: [`Tracker-GUI.cpp`](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Tracker-GUI.cpp) (GUI tracker), [`servo_control.cpp`](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/servo_control.cpp) (Servo controller), [`Sample data/sample_stream.py`](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Sample%20data/sample_stream.py) (CSV replay stream), [`coord_generator.py`](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/coord_generator.py) (Coordinate generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gui["Ground Station GUI"]
  node_landing["Station setup<br/>[Tracker-GUI.cpp]"]
  node_gui_tracker["GUI tracker<br/>[Tracker-GUI.cpp]"]
  node_plot["Trajectory plot<br/>[Tracker-GUI.cpp]"]
end

subgraph group_control["Pointing Control"]
  node_arduino["Servo controller<br/>[servo_control.cpp]"]
  node_console["Console calculator<br/>[servo_control.cpp]"]
end

subgraph group_replay["Telemetry Replay"]
  node_stream["CSV replay stream<br/>[sample_stream.py]"]
  node_generator["Coordinate generator<br/>[coord_generator.py]"]
  node_launch_csv[("Launch telemetry CSV")]
  node_sample_csv[("GPS sample CSV")]
end

subgraph group_plotting["Plotting Library"]
  node_qcustomplot["QCustomPlot<br/>[qcustomplot.h]"]
end

node_operator(("Ground operator"))
node_serial(("Serial telemetry"))
node_servos["Azimuth/elevation servos"]
node_udp(("UDP destination"))

node_operator -->|"enters station coordinates"| node_landing
node_landing -->|"creates tracker"| node_gui_tracker
node_operator -->|"enters rocket coordinates"| node_gui_tracker
node_gui_tracker -->|"stores angle history"| node_plot
node_plot -->|"uses plotting widget"| node_qcustomplot
node_serial -->|"provides coordinate data"| node_arduino
node_arduino -->|"writes servo angles"| node_servos
node_operator -->|"enters CSV data"| node_console
node_launch_csv -->|"supplies replay rows"| node_stream
node_stream -->|"sends UDP coordinates"| node_udp
node_sample_csv -->|"supplies GPS rows"| node_generator
node_generator -->|"sends generated coordinates"| node_udp

click node_landing "https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Tracker-GUI.cpp"
click node_gui_tracker "https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Tracker-GUI.cpp"
click node_plot "https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Tracker-GUI.cpp"
click node_qcustomplot "https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/qcustomplot.h"
click node_arduino "https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/servo_control.cpp"
click node_console "https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Testing/servo_control.cpp"
click node_stream "https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Sample%20data/sample_stream.py"
click node_generator "https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/coord_generator.py"
click node_launch_csv "https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Sample%20data/MetRocketry_10-23-2024_18_36_18.csv"
click node_sample_csv "https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/sample_gps_data.csv"

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_landing,node_gui_tracker,node_plot toneBlue
class node_arduino,node_console toneAmber
class node_stream,node_generator,node_launch_csv,node_sample_csv toneMint
class node_qcustomplot toneRose
class node_operator,node_serial,node_servos,node_udp toneIndigo
```

## Components

### Ground Station GUI

- [Station setup](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Tracker-GUI.cpp): `Tracker-GUI.cpp`
- [GUI tracker](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Tracker-GUI.cpp): `Tracker-GUI.cpp`
- [Trajectory plot](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Tracker-GUI.cpp): `Tracker-GUI.cpp`

### Pointing Control

- [Servo controller](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/servo_control.cpp): `servo_control.cpp`
- [Console calculator](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Testing/servo_control.cpp): `Testing/servo_control.cpp`

### Telemetry Replay

- [CSV replay stream](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Sample%20data/sample_stream.py): `Sample data/sample_stream.py`
- [Coordinate generator](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/coord_generator.py): `coord_generator.py`
- [Launch telemetry CSV](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/Sample%20data/MetRocketry_10-23-2024_18_36_18.csv): `Sample data/MetRocketry_10-23-2024_18_36_18.csv`
- [GPS sample CSV](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/sample_gps_data.csv): `sample_gps_data.csv`

### Plotting Library

- [QCustomPlot](https://github.com/ryerson-rocketry/rocket-antenna-tracker/blob/main/qcustomplot.h): `qcustomplot.h`

### Other components

- **Ground operator**
- **Serial telemetry**
- **Azimuth/elevation servos**
- **UDP destination**

## Connections

- Ground operator → Station setup: enters station coordinates (evidence: `Tracker-GUI.cpp`)
- Station setup → GUI tracker: creates tracker (evidence: `Tracker-GUI.cpp`)
- Ground operator → GUI tracker: enters rocket coordinates (evidence: `Tracker-GUI.cpp`)
- GUI tracker → Trajectory plot: stores angle history (evidence: `Tracker-GUI.cpp`)
- Trajectory plot → QCustomPlot: uses plotting widget (evidence: `Tracker-GUI.cpp`)
- Serial telemetry → Servo controller: provides coordinate data (evidence: `servo_control.cpp`)
- Servo controller → Azimuth/elevation servos: writes servo angles (evidence: `servo_control.cpp`)
- Ground operator → Console calculator: enters CSV data (evidence: `Testing/servo_control.cpp`)
- Launch telemetry CSV → CSV replay stream: supplies replay rows (evidence: `Sample data/sample_stream.py`)
- CSV replay stream → UDP destination: sends UDP coordinates (evidence: `Sample data/sample_stream.py`)
- GPS sample CSV → Coordinate generator: supplies GPS rows (evidence: `coord_generator.py`)
- Coordinate generator → UDP destination: sends generated coordinates (evidence: `coord_generator.py`)
