world_magnetic_model

This crate is a Rust implementation of the NOAA World Magnetic Model, a mathematical model of the magnetic field produced by the Earth's core and its variation over time.

Crate interface is using Units of measurement uom crate for physical quantities representation. WMM coeficient files are converted to code constants to avoid file reading in runtime. Implemented models: WMM2020 and WMM2025.

Usage

let geomagnetic_field = GeomagneticField::new(
    Length::new::<meter>(100.0), // height
    Angle::new::<degree>(54.20), // lat
    Angle::new::<degree>(18.67), // lon
    Date::from_ordinal_date(2023, 15)? // date
)?;

assert_eq!(
    geomagnetic_field.declination().get::<degree>(),
    6.439543
);
assert_eq!(
    geomagnetic_field.declination_uncertainty().get::<degree>(),
    0.41047537
);

World Magnetic Model

The World Magnetic Model is the standard model used by the U.S. Department of Defense, the U.K. Ministry of Defence, the North Atlantic Treaty Organization (NATO) and the International Hydrographic Organization (IHO), for navigation, attitude and heading referencing systems using the geomagnetic field. It is also used widely in civilian navigation and heading systems. The model is produced at 5-year intervals, with the current model expiring on December 31, 2029. The current model WMM2025 is produced jointly by the NCEI and the British Geological Survey (BGS). The model, associated software, and documentation are distributed by NCEI on behalf of US National Geospatial-Intelligence Agency and by BGS on behalf of UK Defence Geographic Centre. [source]

Please refer to World Magnetic Model Accuracy, Limitations, and Error Model.

NOAA License Statement

The WMM source code is in the public domain and not licensed or under copyright. The information and software may be used freely by the public. As required by 17 U.S.C. 403, third parties producing copyrighted works consisting predominantly of the material produced by U.S. government agencies must provide notice with such work(s) identifying the U.S. Government material incorporated and stating that such material is not subject to copyright protection.

The WMM model and associated data files are produced by the U.S. Government and are not subject to copyright.

Credit

This work was inspired from geomag-wmm.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

License: MIT OR Apache-2.0