# sgl-ut/gnsstk-data architecture

> Architecture diagram of the GitHub repository sgl-ut/gnsstk-data, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sgl-ut/gnsstk-data
- Repository: https://github.com/sgl-ut/gnsstk-data

## Overview

This repository is a GNSSTk GNSS command-line tools and associated sample-data subset. Users invoke individual utilities to edit observation or navigation RINEX files, compare observation files, or convert and report times; results are written files or terminal output. The excerpts show each tool’s principal processing responsibilities and timeconvert’s optional navigation-data loading. The tree and README are largely test assets, so they do not establish broader toolkit internals or additional runtime links; those are omitted rather than inferred.

Main entry points: [`core/apps/time/timeconvert.cpp`](https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/time/timeconvert.cpp) (Convert time), [`core/apps/Rinextools/RinEdit.cpp`](https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/Rinextools/RinEdit.cpp) (Edit observations), [`core/apps/Rinextools/RinEditNav.cpp`](https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/Rinextools/RinEditNav.cpp) (Edit navigation), [`core/apps/difftools/rowdiff.cpp`](https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/difftools/rowdiff.cpp) (Compare records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rinex["RINEX editing"]
  node_obs_edit["Edit observations<br/>[RinEdit.cpp]"]
  node_nav_edit["Edit navigation<br/>[RinEditNav.cpp]"]
end

subgraph group_compare["File comparison"]
  node_rowdiff["Compare records<br/>[rowdiff.cpp]"]
end

subgraph group_time["Time conversion"]
  node_timeconvert["Convert time<br/>[timeconvert.cpp]"]
  node_nav_factory["Nav data reader"]
end

node_user(("CLI user"))
node_obs_input["Observation files"]
node_obs_output["Edited RINEX"]
node_nav_input["Navigation files"]
node_nav_output["Navigation output"]
node_compare_inputs["Two observation files"]
node_diff_output["Difference report"]
node_time_user(("Time query"))
node_time_output["Time report"]

node_user -->|"invokes"| node_obs_edit
node_obs_input -->|"reads"| node_obs_edit
node_obs_edit -->|"writes"| node_obs_output
node_user -->|"invokes"| node_nav_edit
node_nav_input -->|"reads"| node_nav_edit
node_nav_edit -->|"writes"| node_nav_output
node_user -->|"invokes"| node_rowdiff
node_compare_inputs -->|"compares"| node_rowdiff
node_rowdiff -->|"prints"| node_diff_output
node_time_user -->|"invokes"| node_timeconvert
node_timeconvert -->|"loads nav data"| node_nav_factory
node_nav_input -->|"provides data"| node_nav_factory
node_timeconvert -->|"reports time"| node_time_output

click node_obs_edit "https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/Rinextools/RinEdit.cpp"
click node_nav_edit "https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/Rinextools/RinEditNav.cpp"
click node_rowdiff "https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/difftools/rowdiff.cpp"
click node_timeconvert "https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/time/timeconvert.cpp"

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_obs_edit,node_nav_edit,node_user toneBlue
class node_rowdiff toneAmber
class node_timeconvert,node_nav_factory toneMint
class node_obs_input,node_obs_output,node_nav_input,node_nav_output,node_compare_inputs,node_diff_output,node_time_user,node_time_output toneIndigo
```

## Components

### RINEX editing

- [Edit observations](https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/Rinextools/RinEdit.cpp): `core/apps/Rinextools/RinEdit.cpp`
- [Edit navigation](https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/Rinextools/RinEditNav.cpp): `core/apps/Rinextools/RinEditNav.cpp`

### File comparison

- [Compare records](https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/difftools/rowdiff.cpp): `core/apps/difftools/rowdiff.cpp`

### Time conversion

- [Convert time](https://github.com/sgl-ut/gnsstk-data/blob/main/core/apps/time/timeconvert.cpp): `core/apps/time/timeconvert.cpp`
- **Nav data reader**

### Other components

- **CLI user**
- **Observation files**
- **Edited RINEX**
- **Navigation files**
- **Navigation output**
- **Two observation files**
- **Difference report**
- **Time query**
- **Time report**

## Connections

- CLI user → Edit observations: invokes (evidence: `core/apps/Rinextools/RinEdit.cpp`)
- Observation files → Edit observations: reads (evidence: `core/apps/Rinextools/RinEdit.cpp`)
- Edit observations → Edited RINEX: writes (evidence: `core/apps/Rinextools/RinEdit.cpp`)
- CLI user → Edit navigation: invokes (evidence: `core/apps/Rinextools/RinEditNav.cpp`)
- Navigation files → Edit navigation: reads (evidence: `core/apps/Rinextools/RinEditNav.cpp`)
- Edit navigation → Navigation output: writes (evidence: `core/apps/Rinextools/RinEditNav.cpp`)
- CLI user → Compare records: invokes (evidence: `core/apps/difftools/rowdiff.cpp`)
- Two observation files → Compare records: compares (evidence: `core/apps/difftools/rowdiff.cpp`)
- Compare records → Difference report: prints (evidence: `core/apps/difftools/rowdiff.cpp`)
- Time query → Convert time: invokes (evidence: `core/apps/time/timeconvert.cpp`)
- Convert time → Nav data reader: loads nav data (evidence: `core/apps/time/timeconvert.cpp`)
- Navigation files → Nav data reader: provides data
- Convert time → Time report: reports time (evidence: `core/apps/time/timeconvert.cpp`)
