geoprimsField-grade geospatial math

Magnetic declination

Magnetic declination (variation), inclination, and field strength at any place and date from WMM2025, high-resolution WMMHR2025, or historical IGRF-14, with compass warning zones.

7.67°

Magnetic declination is 7.7° E, moving 0.081° west each year. The model is good to about 0.37°.

Declination
Declination uncertainty
Annual change
Inclination (dip)
Horizontal intensity H (nT)
North component X (nT)
Provenance
Computed by
geodesy.magnetic.declination 1.1.0, core 0.1.0
Model
WMM2025 main field, degree 12
Accuracy
Matches all 100 NCEI WMM2025 test values and all 12 NCEI WMMHR2025 test values to their printed precision. WMM2025 is good to about 0.3° of declination away from the poles; WMMHR2025 also models regional crustal variation.
Reference data
version WMM2025 (2024-11-13) of a reference dataset
Notes
None
Cites
NOAA National Centers for Environmental Information and British Geological Survey, The US/UK World Magnetic Model for 2025-2030: Technical Report; NOAA National Centers for Environmental Information and British Geological Survey, WMMHR2025 high-resolution geomagnetic model; International Association of Geomagnetism and Aeronomy (IAGA), Working Group V-MOD, International Geomagnetic Reference Field: the fourteenth generation

Something look off?

Your values

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

Loading…

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

Model: WMM2025 (degree 12), WMMHR2025 (degree 133), or IGRF-14 (degree 13) spherical-harmonic field with linear secular variation, on the WGS 84 ellipsoid

Show your work

  1. Model and epoch

    the field the model gives for this place at this date

    wmm2025 at 2,026.712 = 51,083 nT total

  2. Horizontal components

    X north and Y east, the part of the field a compass follows

    X 20,575 nT, Y 2,770 nT = 20,760 nT horizontal

  3. Declination

    D = atan2(Y, X)

    atan2(2,770 nT, 20,575 nT) = 7.67°

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

Accuracy: Matches all 100 NCEI WMM2025 test values and all 12 NCEI WMMHR2025 test values to their printed precision. WMM2025 is good to about 0.3° of declination away from the poles; WMMHR2025 also models regional crustal variation.

When to use this: Use this whenever a magnetic direction meets a true one: setting a compass or a heading indicator, converting a runway or a chart bearing, checking the variation for a flight plan or a survey, or seeing how strong and how steep the field is for a magnetometer. Use WMMHR2025 when regional crustal variation matters, or IGRF-14 for dates back to 1900.

Limitations: WMM2025 and IGRF-14 are smooth global fields; WMMHR2025 adds regional crustal variation but still cannot account for nearby magnetic rock, iron structures, or vehicle deviation. Declination changes year to year, so the date matters, and each model has a validity window that this tool enforces rather than extrapolating past.

Worked example: Boulder, Colorado on September 18, 2026. Source: NCEI WMM2025 synthesis; checked against the published WMM2025 test values (WMM2025_TestValues.txt).

You enter

Date
2026-09-18
Height
1655 m
Latitude
40.015 deg
Longitude
-105.2705 deg

You get

Declination
7.67°
Declination
7.7° E
Declination uncertainty
0.37°
Annual change
-0.081°
Inclination (dip)
66.02°
Horizontal intensity H (nT)
20,760.4 nT
North component X (nT)
20,574.8 nT
East component Y (nT)
2,769.8 nT
Down component Z (nT)
46,673.7 nT
Total intensity F (nT)
51,082.6 nT
Inclination rate (°/year)
-0.05 °/yr
H rate (nT/year)
-8.93 nT/yr
X rate (nT/year)
-4.96 nT/yr
Y rate (nT/year)
-30.14 nT/yr
Z rate (nT/year)
-129.42 nT/yr
F rate (nT/year)
-121.88 nT/yr
Decimal year
2026.712
Compass zone
normal

Review: Not yet independently reviewed by a geodesist.

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

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

Changes

Checked against: 32 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.

Geomagnetic reference radius
6371.2 km — World Magnetic Model
WGS 84 semi-major axis, for the geocentric latitude
6378.137 km — World Magnetic Model
WGS 84 flattening
1/298.257223563 — World Magnetic Model

Sources

Terms

WGS: World Geodetic System
The US Department of Defense global reference frame and ellipsoid that GPS uses; the current version is WGS 84. Source: Department of Defense World Geodetic System 1984