# amar-rahman-05/udip-6-software architecture

> Architecture diagram of the GitHub repository amar-rahman-05/udip-6-software, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amar-rahman-05/udip-6-software
- Repository: https://github.com/amar-rahman-05/udip-6-software

## Overview

UDIP-6 combines onboard flight software with a ground workflow: an operator selects recorded flight data, the ground application converts binary packets to CSV, then presents sensor and sweep analyses. Sweep analysis includes calibrated I–V processing and plasma and altitude views. A separate UDIP-X ground application provides packet and telemetry analysis. The flight firmware and UDIP-X capabilities are only partly sampled; relationships not shown in the excerpts are omitted or marked unverified.

Main entry points: [`UDIP-6-GROUND/UDIP_6_GUI.py`](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GUI.py) (Analysis GUI), [`UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py`](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py) (Sweep analysis), [`UDIP-6-GROUND/CSV-DATA`](https://github.com/amar-rahman-05/udip-6-software/tree/main/UDIP-6-GROUND/CSV-DATA) (Converted CSV data), [`UDIP-6-GROUND/UDIP_6_GROUND_Conversion.py`](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Conversion.py) (Packet converter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_flight["Flight system"]
  node_flight_firmware["Flight firmware"]
  node_flight_hardware["Flight instruments"]
end

subgraph group_ingest["Ground data"]
  node_sd_data[("Flight DAT files")]
  node_converter["Packet converter"]
  node_csv_data[("Converted CSV data")]
end

subgraph group_analysis["Ground analysis"]
  node_ground_gui["Analysis GUI<br/>[UDIP_6_GUI.py]"]
  node_sensor_analysis["Sensor analysis"]
  node_sweep_analysis["Sweep analysis"]
  node_calibration["Sweep calibration<br/>[calibration.py]"]
  node_sweep_plots["Sweep and I–V plots"]
  node_plasma_fit["Plasma estimates"]
  node_altitude_views["Altitude views"]
end

subgraph group_udipx["UDIP-X ground"]
  node_legacy_ground["UDIP-X packet analysis"]
end

node_operator(("Ground operator"))

node_operator -.->|"uses"| node_ground_gui
node_flight_firmware -.->|"interfaces"| node_flight_hardware
node_sd_data -->|"reads"| node_converter
node_converter -->|"writes"| node_csv_data
node_csv_data -->|"reads"| node_sensor_analysis
node_csv_data -->|"reads"| node_sweep_analysis
node_ground_gui -->|"invokes"| node_converter
node_ground_gui -->|"invokes"| node_sensor_analysis
node_ground_gui -->|"invokes"| node_sweep_analysis
node_sweep_analysis -->|"uses"| node_calibration
node_ground_gui -.->|"updates"| node_calibration
node_ground_gui -->|"requests plots"| node_sweep_plots
node_sweep_analysis -->|"fits plasma"| node_plasma_fit
node_sweep_analysis -->|"plots altitude"| node_altitude_views

click node_flight_firmware "https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-FLIGHT/UDIP-6-FlightSoftware.ino"
click node_ground_gui "https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GUI.py"
click node_sd_data "https://github.com/amar-rahman-05/udip-6-software/tree/main/UDIP-6-GROUND/SD-DATA"
click node_converter "https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Conversion.py"
click node_csv_data "https://github.com/amar-rahman-05/udip-6-software/tree/main/UDIP-6-GROUND/CSV-DATA"
click node_sensor_analysis "https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sensor.py"
click node_sweep_analysis "https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py"
click node_calibration "https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/calibration.py"
click node_sweep_plots "https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py"
click node_plasma_fit "https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py"
click node_altitude_views "https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py"
click node_legacy_ground "https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-X%20SOFTWARE/UDIP-X-GROUND-SOFTWARE.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_flight_firmware,node_flight_hardware toneBlue
class node_sd_data,node_converter,node_csv_data toneAmber
class node_ground_gui,node_sensor_analysis,node_sweep_analysis,node_calibration,node_sweep_plots,node_plasma_fit,node_altitude_views toneMint
class node_legacy_ground toneRose
class node_operator toneIndigo
```

## Components

### Flight system

- [Flight firmware](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-FLIGHT/UDIP-6-FlightSoftware.ino): `UDIP-6-FLIGHT/UDIP-6-FlightSoftware.ino`
- **Flight instruments**

### Ground data

- [Flight DAT files](https://github.com/amar-rahman-05/udip-6-software/tree/main/UDIP-6-GROUND/SD-DATA): `UDIP-6-GROUND/SD-DATA`
- [Packet converter](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Conversion.py): `UDIP-6-GROUND/UDIP_6_GROUND_Conversion.py`
- [Converted CSV data](https://github.com/amar-rahman-05/udip-6-software/tree/main/UDIP-6-GROUND/CSV-DATA): `UDIP-6-GROUND/CSV-DATA`

### Ground analysis

- [Analysis GUI](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GUI.py): `UDIP-6-GROUND/UDIP_6_GUI.py`
- [Sensor analysis](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sensor.py): `UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sensor.py`
- [Sweep analysis](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py): `UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py`
- [Sweep calibration](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/calibration.py): `UDIP-6-GROUND/calibration.py`
- [Sweep and I–V plots](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py): `UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py`
- [Plasma estimates](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py): `UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py`
- [Altitude views](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py): `UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py`

### UDIP-X ground

- [UDIP-X packet analysis](https://github.com/amar-rahman-05/udip-6-software/blob/main/UDIP-X%20SOFTWARE/UDIP-X-GROUND-SOFTWARE.py): `UDIP-X SOFTWARE/UDIP-X-GROUND-SOFTWARE.py`

### Other components

- **Ground operator**

## Connections

- Ground operator → Analysis GUI: uses
- Flight firmware → Flight instruments: interfaces
- Flight DAT files → Packet converter: reads (evidence: `UDIP-6-GROUND/UDIP_6_GROUND_Conversion.py`)
- Packet converter → Converted CSV data: writes (evidence: `UDIP-6-GROUND/UDIP_6_GROUND_Conversion.py`)
- Converted CSV data → Sensor analysis: reads (evidence: `UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sensor.py`)
- Converted CSV data → Sweep analysis: reads (evidence: `UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py`)
- Analysis GUI → Packet converter: invokes (evidence: `UDIP-6-GROUND/UDIP_6_GUI.py`)
- Analysis GUI → Sensor analysis: invokes (evidence: `UDIP-6-GROUND/UDIP_6_GUI.py`)
- Analysis GUI → Sweep analysis: invokes (evidence: `UDIP-6-GROUND/UDIP_6_GUI.py`)
- Sweep analysis → Sweep calibration: uses (evidence: `UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py`)
- Analysis GUI → Sweep calibration: updates (evidence: `UDIP-6-GROUND/UDIP_6_GUI.py`)
- Analysis GUI → Sweep and I–V plots: requests plots (evidence: `UDIP-6-GROUND/UDIP_6_GUI.py`)
- Sweep analysis → Plasma estimates: fits plasma (evidence: `UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py`)
- Sweep analysis → Altitude views: plots altitude (evidence: `UDIP-6-GROUND/UDIP_6_GROUND_Analysis_Sweep.py`)
