explaingit

caspermeijn/jord-rs

Analysis updated 2026-07-09 · repo last pushed 2025-03-14

Audience · developerComplexity · 2/5StaleSetup · easy

TLDR

Jord is a Rust library for geographic math on Earth. It calculates distances, bearings, and positions using accurate models, avoiding errors near the poles and dateline that traditional coordinate math suffers from.

Mindmap

mindmap
  root((repo))
    What it does
      Distance calculations
      Bearing and positions
      Coordinate conversions
    Earth models
      Sphere model
      WGS-84 ellipsoid
      N-vector representation
    Use cases
      Drone navigation
      Logistics routing
      Maritime aviation
    Quality
      NavLab test solutions
      Academic algorithms
    Tech stack
      Rust language
      No external deps
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Calculate great-circle distances between warehouses in a logistics app.

USE CASE 2

Compute intercept courses for drones or tracking software.

USE CASE 3

Perform bearing and navigation calculations for maritime or aviation tools.

USE CASE 4

Do path-finding and area containment checks on spherical game worlds.

What is it built with?

Rust

How does it compare?

caspermeijn/jord-rs0xhassaan/nn-from-scratch0xzgbot/hermes-comfyui-skills
Stars00
LanguagePython
Last pushed2025-03-14
MaintenanceStale
Setup difficultyeasymoderateeasy
Complexity2/54/51/5
Audiencedeveloperdeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

In plain English

Jord is a Rust library that handles geographic math, the kind of calculations you need when working with positions on Earth. Think of it as a toolkit for answering questions like: how far apart are these two points? If I travel 1,000 meters at a bearing of 200 degrees, where do I end up? What's the closest point where two moving objects will meet? It converts between different ways of representing locations (like GPS coordinates versus 3D Earth-centered vectors), measures distances along the Earth's curved surface, and works with areas and paths drawn on the globe. The library supports two models of the Earth: a simple sphere and a more accurate ellipsoid (the WGS-84 shape that GPS systems use, which accounts for Earth being slightly squished at the poles). It uses a mathematical approach called "n-vector" representation, which avoids problems that traditional latitude/longitude math runs into near the poles and when crossing the dateline, places where longitude becomes ambiguous or signs flip. Who would use this? Anyone building navigation, mapping, or tracking software. A drone company might use it to calculate intercept courses. A logistics app could compute great-circle distances between warehouses. A maritime or aviation tool might rely on it for bearing calculations across oceans. Game developers building worlds on spherical planets could use it for path-finding and area containment checks. The project is notably rigorous about correctness. It includes solutions to all ten standard test problems from NavLab, a well-known reference site for geographic calculations, so you can verify the library produces accurate results against established benchmarks. The algorithms are grounded in published academic literature on spherical geometry and navigation, not just quick approximations. The code is written in Rust, which means it's designed for performance and safety, useful if you're running these calculations at scale or in systems where errors could have real-world consequences like navigation errors.

Copy-paste prompts

Prompt 1
Using the Jord Rust library, write a function that takes two GPS coordinates and returns the great-circle distance between them in meters.
Prompt 2
Using Jord in Rust, calculate the destination point if I travel 1,000 meters at a bearing of 200 degrees from a given starting latitude and longitude.
Prompt 3
Using Jord's n-vector representation, write Rust code to find the closest point where two moving objects on Earth will meet given their starting positions and velocities.
Prompt 4
Convert between GPS coordinates and 3D Earth-centered vectors using Jord in Rust, and explain why n-vector avoids errors near the poles.

Frequently asked questions

What is jord-rs?

Jord is a Rust library for geographic math on Earth. It calculates distances, bearings, and positions using accurate models, avoiding errors near the poles and dateline that traditional coordinate math suffers from.

Is jord-rs actively maintained?

Stale — no commits in 1-2 years (last push 2025-03-14).

How hard is jord-rs to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is jord-rs for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.