# sgl-ut/gpstk architecture

> Architecture diagram of the GitHub repository sgl-ut/gpstk, 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/gpstk
- Repository: https://github.com/sgl-ut/gpstk

## Overview

GPSTk is an archival GNSS toolkit combining a C++ library with console applications. Users invoke utilities to inspect or transform GNSS files, convert time representations, compare or validate observations, or compute positions. The library supplies format handling, time and satellite models, ephemeris, atmospheric models, and positioning algorithms; README-documented PPP and Python-binding capabilities are also represented. The sampled source is limited, so application-to-library and capability links rely on README statements rather than inferred call chains.

Main entry points: [`core/lib/FileHandling/RINEX3/Rinex3NavStream.hpp`](https://github.com/sgl-ut/gpstk/blob/main/core/lib/FileHandling/RINEX3/Rinex3NavStream.hpp) (RINEX Handling), [`core/apps/positioning/PRSolve.cpp`](https://github.com/sgl-ut/gpstk/blob/main/core/apps/positioning/PRSolve.cpp) (Position Solving), [`core/lib/Geomatics`](https://github.com/sgl-ut/gpstk/tree/main/core/lib/Geomatics) (PPP Processing), [`core/apps/Rinextools/RinDump.cpp`](https://github.com/sgl-ut/gpstk/blob/main/core/apps/Rinextools/RinDump.cpp) (RINEX Utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["GNSS Applications"]
  node_rinex_tools["RINEX Utilities<br/>[RinDump.cpp]"]
  node_rinex_nav["Navigation Utility<br/>[RinNav.cpp]"]
  node_positioning["Position Solving<br/>[PRSolve.cpp]"]
  node_relative_positioning["Relative Positioning"]
  node_file_compare["File Comparison<br/>[rowdiff.cpp]"]
  node_file_validation["File Validation"]
  node_time_tools["Time Conversion<br/>[timeconvert.cpp]"]
  node_data_editing["Data Editing<br/>[RinEdit.cpp]"]
end

subgraph group_formats["Data Formats"]
  node_rinex_formats["RINEX Handling"]
  node_other_formats["Other Formats<br/>[SP3Stream.hpp]"]
end

subgraph group_models["GNSS Models"]
  node_ephemerides["Ephemeris"]
  node_atmospheric_models["Atmospheric Models<br/>[IonoModel.cpp]"]
  node_position_algorithms["Position Algorithms<br/>[PRSolution.cpp]"]
  node_ppp["PPP Processing"]
end

subgraph group_foundations["Core Foundations"]
  node_time_systems["Time Systems<br/>[CommonTime.hpp]"]
  node_satellite_data["GNSS Data Types<br/>[Position.hpp]"]
  node_app_framework["Application Framework<br/>[BasicFramework.cpp]"]
  node_python_bindings["Python Bindings<br/>[gpstk_swig.hpp]"]
end

node_user(("GNSS User"))

node_user -->|"uses"| node_rinex_tools
node_user -->|"requests solution"| node_positioning
node_user -->|"converts time"| node_time_tools
node_user -->|"compares files"| node_file_compare
node_user -->|"validates files"| node_file_validation
node_user -->|"edits data"| node_data_editing
node_user -->|"surveys with"| node_relative_positioning
node_rinex_tools -->|"uses formats"| node_rinex_formats
node_rinex_nav -->|"uses formats"| node_rinex_formats
node_positioning -.->|"reads observations"| node_rinex_formats
node_positioning -.->|"uses ephemerides"| node_ephemerides
node_positioning -.->|"solves position"| node_position_algorithms
node_relative_positioning -.->|"computes position"| node_position_algorithms
node_time_tools -->|"converts representations"| node_time_systems
node_rinex_formats -.->|"represents observations"| node_satellite_data
node_other_formats -.->|"supports precise ephemerides"| node_ephemerides
node_position_algorithms -.->|"models delays"| node_atmospheric_models
node_ppp -.->|"processes GNSS data"| node_rinex_formats
node_ppp -.->|"uses ephemerides"| node_ephemerides
node_ppp -.->|"models delays"| node_atmospheric_models
node_rinex_tools -.->|"uses framework"| node_app_framework
node_python_bindings -->|"exposes library"| node_time_systems

click node_rinex_tools "https://github.com/sgl-ut/gpstk/blob/main/core/apps/Rinextools/RinDump.cpp"
click node_rinex_nav "https://github.com/sgl-ut/gpstk/blob/main/ext/apps/Rinextools/RinNav.cpp"
click node_positioning "https://github.com/sgl-ut/gpstk/blob/main/core/apps/positioning/PRSolve.cpp"
click node_relative_positioning "https://github.com/sgl-ut/gpstk/tree/main/ext/apps/geomatics/relposition"
click node_file_compare "https://github.com/sgl-ut/gpstk/blob/main/core/apps/difftools/rowdiff.cpp"
click node_file_validation "https://github.com/sgl-ut/gpstk/tree/main/core/apps/checktools"
click node_time_tools "https://github.com/sgl-ut/gpstk/blob/main/core/apps/time/timeconvert.cpp"
click node_data_editing "https://github.com/sgl-ut/gpstk/blob/main/core/apps/Rinextools/RinEdit.cpp"
click node_rinex_formats "https://github.com/sgl-ut/gpstk/blob/main/core/lib/FileHandling/RINEX3/Rinex3NavStream.hpp"
click node_other_formats "https://github.com/sgl-ut/gpstk/blob/main/core/lib/FileHandling/SP3/SP3Stream.hpp"
click node_ephemerides "https://github.com/sgl-ut/gpstk/blob/main/core/lib/GNSSEph/GPSEphemerisStore.cpp"
click node_atmospheric_models "https://github.com/sgl-ut/gpstk/blob/main/core/lib/GNSSCore/IonoModel.cpp"
click node_position_algorithms "https://github.com/sgl-ut/gpstk/blob/main/core/lib/PosSol/PRSolution.cpp"
click node_ppp "https://github.com/sgl-ut/gpstk/tree/main/core/lib/Geomatics"
click node_time_systems "https://github.com/sgl-ut/gpstk/blob/main/core/lib/TimeHandling/CommonTime.hpp"
click node_satellite_data "https://github.com/sgl-ut/gpstk/blob/main/core/lib/GNSSCore/Position.hpp"
click node_app_framework "https://github.com/sgl-ut/gpstk/blob/main/core/lib/AppFrame/BasicFramework.cpp"
click node_python_bindings "https://github.com/sgl-ut/gpstk/blob/main/swig/src/gpstk_swig.hpp"

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_rinex_tools,node_rinex_nav,node_positioning,node_relative_positioning,node_file_compare,node_file_validation,node_time_tools,node_data_editing,node_user toneBlue
class node_rinex_formats,node_other_formats toneAmber
class node_ephemerides,node_atmospheric_models,node_position_algorithms,node_ppp toneMint
class node_time_systems,node_satellite_data,node_app_framework,node_python_bindings toneRose
```

## Components

### GNSS Applications

- [RINEX Utilities](https://github.com/sgl-ut/gpstk/blob/main/core/apps/Rinextools/RinDump.cpp): `core/apps/Rinextools/RinDump.cpp`
- [Navigation Utility](https://github.com/sgl-ut/gpstk/blob/main/ext/apps/Rinextools/RinNav.cpp): `ext/apps/Rinextools/RinNav.cpp`
- [Position Solving](https://github.com/sgl-ut/gpstk/blob/main/core/apps/positioning/PRSolve.cpp): `core/apps/positioning/PRSolve.cpp`
- [Relative Positioning](https://github.com/sgl-ut/gpstk/tree/main/ext/apps/geomatics/relposition): `ext/apps/geomatics/relposition`
- [File Comparison](https://github.com/sgl-ut/gpstk/blob/main/core/apps/difftools/rowdiff.cpp): `core/apps/difftools/rowdiff.cpp`
- [File Validation](https://github.com/sgl-ut/gpstk/tree/main/core/apps/checktools): `core/apps/checktools`
- [Time Conversion](https://github.com/sgl-ut/gpstk/blob/main/core/apps/time/timeconvert.cpp): `core/apps/time/timeconvert.cpp`
- [Data Editing](https://github.com/sgl-ut/gpstk/blob/main/core/apps/Rinextools/RinEdit.cpp): `core/apps/Rinextools/RinEdit.cpp`

### Data Formats

- [RINEX Handling](https://github.com/sgl-ut/gpstk/blob/main/core/lib/FileHandling/RINEX3/Rinex3NavStream.hpp): `core/lib/FileHandling/RINEX3/Rinex3NavStream.hpp`
- [Other Formats](https://github.com/sgl-ut/gpstk/blob/main/core/lib/FileHandling/SP3/SP3Stream.hpp): `core/lib/FileHandling/SP3/SP3Stream.hpp`

### GNSS Models

- [Ephemeris](https://github.com/sgl-ut/gpstk/blob/main/core/lib/GNSSEph/GPSEphemerisStore.cpp): `core/lib/GNSSEph/GPSEphemerisStore.cpp`
- [Atmospheric Models](https://github.com/sgl-ut/gpstk/blob/main/core/lib/GNSSCore/IonoModel.cpp): `core/lib/GNSSCore/IonoModel.cpp`
- [Position Algorithms](https://github.com/sgl-ut/gpstk/blob/main/core/lib/PosSol/PRSolution.cpp): `core/lib/PosSol/PRSolution.cpp`
- [PPP Processing](https://github.com/sgl-ut/gpstk/tree/main/core/lib/Geomatics): `core/lib/Geomatics`

### Core Foundations

- [Time Systems](https://github.com/sgl-ut/gpstk/blob/main/core/lib/TimeHandling/CommonTime.hpp): `core/lib/TimeHandling/CommonTime.hpp`
- [GNSS Data Types](https://github.com/sgl-ut/gpstk/blob/main/core/lib/GNSSCore/Position.hpp): `core/lib/GNSSCore/Position.hpp`
- [Application Framework](https://github.com/sgl-ut/gpstk/blob/main/core/lib/AppFrame/BasicFramework.cpp): `core/lib/AppFrame/BasicFramework.cpp`
- [Python Bindings](https://github.com/sgl-ut/gpstk/blob/main/swig/src/gpstk_swig.hpp): `swig/src/gpstk_swig.hpp`

### Other components

- **GNSS User**

## Connections

- GNSS User → RINEX Utilities: uses
- GNSS User → Position Solving: requests solution
- GNSS User → Time Conversion: converts time
- GNSS User → File Comparison: compares files
- GNSS User → File Validation: validates files
- GNSS User → Data Editing: edits data
- GNSS User → Relative Positioning: surveys with
- RINEX Utilities → RINEX Handling: uses formats (evidence: `core/apps/Rinextools/RinDump.cpp`)
- Navigation Utility → RINEX Handling: uses formats (evidence: `ext/apps/Rinextools/RinNav.cpp`)
- Position Solving → RINEX Handling: reads observations (evidence: `core/apps/positioning/PRSolve.cpp`)
- Position Solving → Ephemeris: uses ephemerides
- Position Solving → Position Algorithms: solves position
- Relative Positioning → Position Algorithms: computes position
- Time Conversion → Time Systems: converts representations
- RINEX Handling → GNSS Data Types: represents observations
- Other Formats → Ephemeris: supports precise ephemerides
- Position Algorithms → Atmospheric Models: models delays
- PPP Processing → RINEX Handling: processes GNSS data
- PPP Processing → Ephemeris: uses ephemerides
- PPP Processing → Atmospheric Models: models delays
- RINEX Utilities → Application Framework: uses framework
- Python Bindings → Time Systems: exposes library (evidence: `swig/src/gpstk_swig.hpp`)
