geoprimsField-grade geospatial math

Navigation log

A VFR navigation log for a whole route: each leg’s true course, distance, wind correction, true, magnetic, and compass heading, groundspeed, time, and fuel, with the totals.

Planning and education aid. Not for primary navigation. Full disclaimer

30min

The route is 52.6 NM in 2 legs, 30 min in all, burning 4 US gal.

  • gal/h was read as US gallons per hour, not imperial gallons.
Route
LatitudeLongitudeName
35.0967000 deg-97.9678000 degKCHK
35.5342000 deg-97.6471000 degKPWA
35.8498000 deg-97.4156000 degKGOK
Total distance
Total fuel
Legs
Provenance
Computed by
aviation.flight-plan.nav-log 1.0.0, core 0.1.0
Model
Course and distance: Karney geodesic inverse on WGS 84 (or the chart values given). Heading and groundspeed: the wind triangle of aviation.wind.heading-groundspeed, WCA = asin(W/TAS · sin(WD − TC)), GS = TAS·cos(WCA) − W·cos(WD − TC). MH = TH − variation (east positive), from the value given or WMM2025 at the leg’s start; CH = MH − deviation, read from the card by linear interpolation. Time = distance ÷ GS; fuel = time × burn
Accuracy
Exact arithmetic for steady winds; the geodesic to nanometers; WMM2025 variation about ±0.5° typical. Planning aid, not certified for navigation.
Notes
1 shown with the answer
Cites
Federal Aviation Administration, Pilot's Handbook of Aeronautical Knowledge, FAA-H-8083-25C; NOAA National Centers for Environmental Information and British Geological Survey, The US/UK World Magnetic Model for 2025-2030: Technical Report

Something look off?

Your values

Showing an example. Change anything.
KML, KMZ, GPX, GeoJSON, CSV, WKT, or WKB — or drop it on the box. Read on this device.
More options 4
Run many at once from a CSV

Loading…

How we got thisFormula, worked example, sources, and proof

Model: Course and distance: Karney geodesic inverse on WGS 84 (or the chart values given). Heading and groundspeed: the wind triangle of aviation.wind.heading-groundspeed, WCA = asin(W/TAS · sin(WD − TC)), GS = TAS·cos(WCA) − W·cos(WD − TC). MH = TH − variation (east positive), from the value given or WMM2025 at the leg’s start; CH = MH − deviation, read from the card by linear interpolation. Time = distance ÷ GS; fuel = time × burn

Show your work

  1. Leg 1 heading

    TH = TC + WCA, WCA = asin(W/TAS · sin(WD − TC))

    31° − 2.6° = 28°

  2. Leg 1 time

    time = distance ÷ groundspeed

    30.6 NM ÷ 106.3 kt × 60 = 17 min

  3. Total time

    Σ leg times

    17.3 + 12.4 = 30 min

The same steps an agent gets from the MCP server with explain: true.

Accuracy: Exact arithmetic for steady winds; the geodesic to nanometers; WMM2025 variation about ±0.5° typical. Planning aid, not certified for navigation.

When to use this: Use this to fill in a navigation log for a cross-country flight: give the waypoints (or the course and distance of each leg from the chart), your true airspeed, the winds aloft, and the fuel burn, and it works every leg the way the planning sheet does, from true course to compass heading, with the time and fuel for each leg and the totals.

Limitations: Each leg is flown at cruise true airspeed in a steady wind, so the climb, the descent, and any wind change inside a leg are not in it: add the climb from the climb plan and plan the fuel reserve with the fuel planner. The winds are true, as forecast. The course from waypoints is the geodesic’s course leaving each waypoint, which drifts along a long leg. Planning aid, not for primary navigation.

Worked example: Chickasha to Wiley Post to Guthrie at 115 kt, wind 360° at 10 kt. Source: The PHAK chapter 16 trip's numbers (TAS 115 kt, wind 360° at 10 kt, 7° E variation, 8 GPH) over approximate positions of Chickasha, Wiley Post (its checkpoint 3), and Guthrie. It is golden test vector v003, and every build checks the tool still gives its answer within its tolerance.

You enter

Fuel burn
8 gal/h
True airspeed
115 kt
Magnetic variation
7 deg
Waypoints
KCHK, 35.0967, -97.9678 KPWA, 35.5342, -97.6471 KGOK, 35.8498, -97.4156
Wind direction
360 deg
Wind speed
10 kt

You get

Total time
30 min
Total distance
52.6 NM
Total fuel
4 US gal
Legs
2

Review: Not yet independently reviewed by a flight instructor (CFI).

Last verified: 2026-09-18, when a maintainer last confirmed this tool's sources at the issuer. See the sources ledger.

Status: version 1.0.0, core 0.1.0. See this tool in the verification report.

Changes

Checked against: 20 golden test vectors (download the test vectors, each with its source and tolerance). See how results are checked and every source.

Constants this tool assumes

Values you do not enter, and where each comes from.

WGS 84 semi-major axis
6378137 m — Department of Defense World Geodetic System 1984
WGS 84 inverse flattening
298.257223563 — Department of Defense World Geodetic System 1984
Geomagnetic reference radius, for the WMM2025 variation
6371.2 km — World Magnetic Model

Sources

Terms

WMM: World Magnetic Model
The model of the Earth's magnetic field used by charts and GPS units to give magnetic variation for a place and date. It is replaced every five years; WMM2025 runs to 2030. Source: World Magnetic Model