GeographicLib Benchmarks

Direct problem (500k cases):

Inverse problem (500k cases):

Benchmark comparison of geodesic calculation performance across different language implementations of GeographicLib.

Languages & Libraries

Language	Library	Version
C++	GeographicLib	2.7
Java	GeographicLib-Java	2.1
Go	geographiclib-go	2.1.2
Rust	geographiclib-rs	0.2.5

Benchmarks

Two geodesic problems are benchmarked:

• Direct: Given a starting point, azimuth, and distance, find the destination point
• Inverse: Given two points, find the distance and azimuths between them

Each benchmark runs 500,000 test cases from the official GeodTest.dat dataset, repeated 50 times.

Running Benchmarks

Prerequisites

• C++: CMake, GeographicLib development headers, Boost
• Java: JDK 11+, Maven
• Go: Go 1.25+
• Rust: Rust 1.70+
• Python 3 (for analysis script)

Local Execution

# Build, run, and analyze all benchmarks
make run analyze

Docker

docker build -t geographiclib-benchmarks .
docker run --rm geographiclib-benchmarks

Individual Benchmarks

# Build specific implementation
make build-cpp
make build-java
make build-go
make build-rust

# Run specific benchmark
make run-cpp
make run-java
make run-go
make run-rust

Results

Results are stored as JSON in the results/ directory. The analysis script produces a summary like:

================================================================================
GeographicLib Benchmark Results
================================================================================

Test cases: 500,000
Runs per benchmark: 50

----------------------------------------
Direct (geodesic forward problem)
----------------------------------------
Language   Median (ms)    StdDev     Relative   Library
--------------------------------------------------------------------------------
rust       93.41          ±1.83      1.00x      geographiclib-rs 0.2.5
cpp        100.73         ±0.79      1.08x      GeographicLib 2.7
go         103.81         ±0.91      1.11x      geographiclib-go 2.1.2
java       120.54         ±2.06      1.29x      GeographicLib-Java 2.1

----------------------------------------
Inverse (geodesic inverse problem)
----------------------------------------
Language   Median (ms)    StdDev     Relative   Library
--------------------------------------------------------------------------------
rust       174.90         ±1.14      1.00x      geographiclib-rs 0.2.5
cpp        194.87         ±1.29      1.11x      GeographicLib 2.7
go         280.98         ±4.02      1.61x      geographiclib-go 2.1.2
java       291.94         ±6.05      1.67x      GeographicLib-Java 2.1

CI/CD

GitHub Actions runs benchmarks automatically on push/PR. Results are uploaded as artifacts.

License

MIT