magnetismi

Magnetism (Finnish: magnetismi) - another opinionated World Magnetic Model calculator.

License: MIT

Model

References

[WMM20] : "The US/UK World Magnetic Model for 2020-2025: Technical Report", Personal Author(s) : Chulliat, A.;W. Brown;P. Alken;C. Beggan;M. Nair;G. Cox;A. Woods;S. Macmillan;B. Meyer;M. Paniccia; Corporate Authors(s) : National Centers for Environmental Information (U.S.);British Geological Survey; Published Date : 2020, DOI : https://doi.org/10.25923/ytk1-yx35

Interface to the Source Data

The mode in use is the current World Magnetic Model from 2020 [WMM20] with is considered valid through 2025. For information on the state of the geomagnetic field the latest report is per December 2021 The corresponding coefficient file is per WMM2020COF.zip. The COF file format is documented on the page WMM coefficient file format for developers including example code to read the coefficients.

The Magnetic Elements

Citing the model report [WMM20] section 1.1.1:

The geomagnetic field vector, Bm, is described by seven elements. These are the northerly intensity X, the easterly intensity Y, the vertical intensity Z (positive downwards) and the following quantities derived from X, Y and Z: the horizontal intensity H, the total intensity F, the inclination angle I, (also called the dip angle and measured from the horizontal plane to the field vector, positive downwards) and the declination angle D (also called the magnetic variation and measured clockwise from true north to the horizontal component of the field vector). In the descriptions of X, Y, Z, H, F, I and D above, the vertical direction is perpendicular to the WGS 84 ellipsoid model of the Earth, the horizontal plane is perpendicular to the vertical direction, and the rotational directions clockwise and counter-clockwise are determined by a view from above [...]

The quantities X, Y and Z are the sizes of perpendicular vectors that add vectorially to Bm. Conversely, X, Y and Z can be determined from the quantities F, I and D (i.e., the quantities that specify the size and direction of Bm).

Ranges of the Magnetic Element Values

The below table depicts the expected value ranges of the magnetic field elements (Source: [WMM20] table 1 in section 1.1.1):

Documentation

User and developer documentation of magnetismi.

Bug Tracker

Feature requests and bug reports are best entered in the todos of magnetismi.

Primary Source repository

The primary source of magnetismi lives somewhere on a mountain in Central Switzerland. But, we use decentralized version control (git), so any clone can become the source to everyone's benefit, no central only code. Anyway, the preferred public clones of magnetismi are:

• on codeberg - a democratic community-driven, non-profit software development platform operated by Codeberg e.V.
• at sourcehut - a collection of tools useful for software development.

Status

Experimental

Note: The default branch is default.