# geographiclib/geographiclib architecture

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

- Interactive diagram: https://gitdiagram.com/geographiclib/geographiclib
- Repository: https://github.com/geographiclib/geographiclib

## Overview

GeographicLib is a C++ library for geodesic and rhumb-line calculations, coordinate conversion, gravity and magnetic-field evaluation, and triaxial-ellipsoid computation. The principal user workflow is to supply geographic or ellipsoidal inputs to a library API and obtain calculated positions, conversions, or field values. The tree also shows command-line tools and language wrappers as user-facing entry points. The README documents the capability areas, but sampled source does not establish most tool-to-library call paths, so those internal relationships are not drawn.

Main entry points: [`src/Geodesic.cpp`](https://github.com/geographiclib/geographiclib/blob/main/src/Geodesic.cpp) (Geodesics), [`include/GeographicLib/Rhumb.hpp`](https://github.com/geographiclib/geographiclib/blob/main/include/GeographicLib/Rhumb.hpp) (Rhumb lines), [`src/Geodesic3.cpp`](https://github.com/geographiclib/geographiclib/blob/main/src/Geodesic3.cpp) (Triaxial geodesics), [`src/UTMUPS.cpp`](https://github.com/geographiclib/geographiclib/blob/main/src/UTMUPS.cpp) (Coordinate systems)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_geodesy["Geodesic calculations"]
  node_geodesics["Geodesics<br/>[Geodesic.cpp]"]
  node_exact_geodesics["Exact geodesics<br/>[GeodesicExact.cpp]"]
  node_rhumb_lines["Rhumb lines<br/>[Rhumb.hpp]"]
  node_geodesic_lines["Geodesic lines<br/>[GeodesicLine.hpp]"]
  node_triaxial_geodesics["Triaxial geodesics<br/>[Geodesic3.cpp]"]
  node_triaxial_ode["ODE geodesics"]
  node_geodesic30["Order-30 geodesics<br/>[Geodesic30.cpp]"]
  node_geodesic30_line["Order-30 lines<br/>[GeodesicLine30.hpp]"]
end

subgraph group_coordinates["Coordinate conversion"]
  node_coordinate_systems["Coordinate systems<br/>[UTMUPS.cpp]"]
  node_geographic_coordinates["Geographic coordinates<br/>[GeoCoords.cpp]"]
  node_cartesian["Cartesian conversion<br/>[Geocentric.cpp]"]
  node_local_cartesian["Local Cartesian<br/>[LocalCartesian.cpp]"]
end

subgraph group_fields["Earth field models"]
  node_geoid["Geoid heights<br/>[Geoid.cpp]"]
  node_gravity["Gravity models<br/>[GravityModel.cpp]"]
  node_magnetic["Magnetic models<br/>[MagneticModel.cpp]"]
end

subgraph group_interfaces["User interfaces"]
  node_tools["Command-line tools<br/>[GeodSolve.cpp]"]
  node_c_geoid["C geoid wrapper<br/>[cgeoid.cpp]"]
  node_excel_geodesic["Excel geodesic wrapper<br/>[cgeodesic.cpp]"]
  node_python_wrapper["Python wrapper"]
end

node_users(("Library users"))

node_users -->|"request calculations"| node_geodesics
node_users -->|"request calculations"| node_rhumb_lines
node_users -->|"request conversions"| node_coordinate_systems
node_users -->|"request conversions"| node_cartesian
node_users -->|"request field values"| node_gravity
node_users -->|"request field values"| node_magnetic
node_users -->|"request calculations"| node_triaxial_geodesics

click node_geodesics "https://github.com/geographiclib/geographiclib/blob/main/src/Geodesic.cpp"
click node_exact_geodesics "https://github.com/geographiclib/geographiclib/blob/main/src/GeodesicExact.cpp"
click node_rhumb_lines "https://github.com/geographiclib/geographiclib/blob/main/include/GeographicLib/Rhumb.hpp"
click node_geodesic_lines "https://github.com/geographiclib/geographiclib/blob/main/include/GeographicLib/GeodesicLine.hpp"
click node_triaxial_geodesics "https://github.com/geographiclib/geographiclib/blob/main/src/Geodesic3.cpp"
click node_triaxial_ode "https://github.com/geographiclib/geographiclib/blob/main/experimental/TriaxialGeodesicODE.cpp"
click node_geodesic30 "https://github.com/geographiclib/geographiclib/blob/main/develop/Geodesic30.cpp"
click node_geodesic30_line "https://github.com/geographiclib/geographiclib/blob/main/develop/GeodesicLine30.hpp"
click node_coordinate_systems "https://github.com/geographiclib/geographiclib/blob/main/src/UTMUPS.cpp"
click node_geographic_coordinates "https://github.com/geographiclib/geographiclib/blob/main/src/GeoCoords.cpp"
click node_cartesian "https://github.com/geographiclib/geographiclib/blob/main/src/Geocentric.cpp"
click node_local_cartesian "https://github.com/geographiclib/geographiclib/blob/main/src/LocalCartesian.cpp"
click node_geoid "https://github.com/geographiclib/geographiclib/blob/main/src/Geoid.cpp"
click node_gravity "https://github.com/geographiclib/geographiclib/blob/main/src/GravityModel.cpp"
click node_magnetic "https://github.com/geographiclib/geographiclib/blob/main/src/MagneticModel.cpp"
click node_tools "https://github.com/geographiclib/geographiclib/blob/main/tools/GeodSolve.cpp"
click node_c_geoid "https://github.com/geographiclib/geographiclib/blob/main/wrapper/c/cgeoid.cpp"
click node_excel_geodesic "https://github.com/geographiclib/geographiclib/blob/main/wrapper/excel/cgeodesic.cpp"
click node_python_wrapper "https://github.com/geographiclib/geographiclib/blob/main/wrapper/python/PyGeographicLib.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_geodesics,node_exact_geodesics,node_rhumb_lines,node_geodesic_lines,node_triaxial_geodesics,node_triaxial_ode,node_geodesic30,node_geodesic30_line,node_users toneBlue
class node_coordinate_systems,node_geographic_coordinates,node_cartesian,node_local_cartesian toneAmber
class node_geoid,node_gravity,node_magnetic toneMint
class node_tools,node_c_geoid,node_excel_geodesic,node_python_wrapper toneRose
```

## Components

### Geodesic calculations

- [Geodesics](https://github.com/geographiclib/geographiclib/blob/main/src/Geodesic.cpp): `src/Geodesic.cpp`
- [Exact geodesics](https://github.com/geographiclib/geographiclib/blob/main/src/GeodesicExact.cpp): `src/GeodesicExact.cpp`
- [Rhumb lines](https://github.com/geographiclib/geographiclib/blob/main/include/GeographicLib/Rhumb.hpp): `include/GeographicLib/Rhumb.hpp`
- [Geodesic lines](https://github.com/geographiclib/geographiclib/blob/main/include/GeographicLib/GeodesicLine.hpp): `include/GeographicLib/GeodesicLine.hpp`
- [Triaxial geodesics](https://github.com/geographiclib/geographiclib/blob/main/src/Geodesic3.cpp): `src/Geodesic3.cpp`
- [ODE geodesics](https://github.com/geographiclib/geographiclib/blob/main/experimental/TriaxialGeodesicODE.cpp): `experimental/TriaxialGeodesicODE.cpp`
- [Order-30 geodesics](https://github.com/geographiclib/geographiclib/blob/main/develop/Geodesic30.cpp): `develop/Geodesic30.cpp`
- [Order-30 lines](https://github.com/geographiclib/geographiclib/blob/main/develop/GeodesicLine30.hpp): `develop/GeodesicLine30.hpp`

### Coordinate conversion

- [Coordinate systems](https://github.com/geographiclib/geographiclib/blob/main/src/UTMUPS.cpp): `src/UTMUPS.cpp`
- [Geographic coordinates](https://github.com/geographiclib/geographiclib/blob/main/src/GeoCoords.cpp): `src/GeoCoords.cpp`
- [Cartesian conversion](https://github.com/geographiclib/geographiclib/blob/main/src/Geocentric.cpp): `src/Geocentric.cpp`
- [Local Cartesian](https://github.com/geographiclib/geographiclib/blob/main/src/LocalCartesian.cpp): `src/LocalCartesian.cpp`

### Earth field models

- [Geoid heights](https://github.com/geographiclib/geographiclib/blob/main/src/Geoid.cpp): `src/Geoid.cpp`
- [Gravity models](https://github.com/geographiclib/geographiclib/blob/main/src/GravityModel.cpp): `src/GravityModel.cpp`
- [Magnetic models](https://github.com/geographiclib/geographiclib/blob/main/src/MagneticModel.cpp): `src/MagneticModel.cpp`

### User interfaces

- [Command-line tools](https://github.com/geographiclib/geographiclib/blob/main/tools/GeodSolve.cpp): `tools/GeodSolve.cpp`
- [C geoid wrapper](https://github.com/geographiclib/geographiclib/blob/main/wrapper/c/cgeoid.cpp): `wrapper/c/cgeoid.cpp`
- [Excel geodesic wrapper](https://github.com/geographiclib/geographiclib/blob/main/wrapper/excel/cgeodesic.cpp): `wrapper/excel/cgeodesic.cpp`
- [Python wrapper](https://github.com/geographiclib/geographiclib/blob/main/wrapper/python/PyGeographicLib.cpp): `wrapper/python/PyGeographicLib.cpp`

### Other components

- **Library users**

## Connections

- Library users → Geodesics: request calculations (evidence: `README.md`)
- Library users → Rhumb lines: request calculations (evidence: `README.md`)
- Library users → Coordinate systems: request conversions (evidence: `README.md`)
- Library users → Cartesian conversion: request conversions (evidence: `README.md`)
- Library users → Gravity models: request field values (evidence: `README.md`)
- Library users → Magnetic models: request field values (evidence: `README.md`)
- Library users → Triaxial geodesics: request calculations (evidence: `README.md`)
