geoprimsField-grade geospatial math

Wind triangle: course and groundspeed from a heading

Where a heading and true airspeed will take you in a known wind: the course over the ground, the groundspeed, and the drift.

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

Experimental: not yet fully verified. How results are checked

90°

Heading 81.7° makes good a course of 90° at 108.7 kt over the ground.

Groundspeed
Drift angle
Provenance
Computed by
aviation.wind.course-from-heading 1.0.0, core 0.1.0
Model
Ground vector = air vector + wind vector: the air vector runs along the heading at TAS, and the wind vector points where the wind blows to (its direction + 180°). The course is the ground vector's direction and the groundspeed its length
Accuracy
Exact for steady wind and flat-earth geometry over a leg. 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; Federal Aviation Administration, Aeronautical Information Manual

Something look off?

Your values

Showing an example. Change anything.
More options 4
Run many at once from a CSV

Loading…

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

Model: Ground vector = air vector + wind vector: the air vector runs along the heading at TAS, and the wind vector points where the wind blows to (its direction + 180°). The course is the ground vector's direction and the groundspeed its length

Show your work

  1. Ground vector

    ground = air + wind (east, north)

    (118.7, 17.3) + (-10, -17.3) = (108.7, 0) kt

  2. Groundspeed

    GS=|ground|

    √(108.7² + 0²) = 108.7 kt

  3. Course over the ground

    course = atan2(east, north)

    atan2(108.7, 0) = 90°

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

Accuracy: Exact for steady wind and flat-earth geometry over a leg. Planning aid, not certified for navigation.

Worked example: Heading 081.7° at 120 kt, wind 030° at 20 kt. Source: add-aviation-suite heading-and-groundspeed scenario solved the other way: course about 090° at 108.7 kt. It is golden test vector v001, and every build checks the tool still gives its answer within its tolerance.

You enter

Heading
81.7 deg
True airspeed
120 kt
Wind direction
30 deg
Wind speed
20 kt

You get

Course over the ground
90°
Groundspeed
108.7 kt
Drift angle
8.3°

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

Last verified: 2026-09-19, 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.

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

Sources

Terms

METAR: aviation routine weather report
An airport weather observation in a standard code: wind, visibility, weather, clouds, temperature, dew point, and altimeter setting, issued at least hourly. Source: Aviation Weather Handbook
TAF: terminal aerodrome forecast
A forecast for an airport, usually 24 or 30 hours long, coded like a METAR with change groups such as FM, TEMPO, BECMG, and PROB30. Source: Aviation Weather Handbook

Experimental means this tool has not yet met the stable bar: at least 20 golden vectors, differential tests, and an independent worked example.