Pure Go IGRF (International Geomagnetic Reference Field). This is based on the existing C implementation. This package computes values for the geomagnetic field and secular variation for a given set of coordinates and date.
latgeodetic latitude (WGS84 latitude) in decimal degrees, valid values -90.0 < lat < 90.0;longeodetic longitude (WGS84 longitude) in decimal degrees, valid values -180.0 < lon < 180.0;altgeodetic altitude above mean sea level in km (-1.00 to 600.00);datedecimal date, starting from 1900.00.
The output is of type type IGRFresults struct. Fields are:
| Field name | Fortran name | Unit of measurement | Sample value | Notes |
|---|---|---|---|---|
| Declination | (D) | decimal degrees(°) | 14.175 ° | (+ve east) |
| DeclinationSV | (D) | arcmin/yr | -8.92 | |
| Inclination | (I) | decimal degrees(°) | 74.229 | (+ve down) |
| InclinationSV | (I) | arcmin/yr | -2.59 | |
| HzIntensity | Horizontal intensity (H) | nT | 14626.6 | |
| HorizontalSV | (H) | nT/yr | -16.8 | |
| NorthComponent | (X) | nT | 14181.2 | |
| NorthSV | (X) | nT/yr | -28.2 | |
| EastComponent | (Y) | nT | 3581.8 | |
| EastSV | (Y) | nT/yr | 32.0 | |
| VerticalComponent | (Z) | nT | 51788.4 | downward |
| VerticalSV | (Z) | nT/yr | 80.1 | |
| TotalIntensity | (F) | nT | 53814.3 | |
| TotalSV | (F) | nT/yr | 71.8 |
The SV values are computed by subtracting the values for the desired input date from corresponding values one year later.
Unlike in C implementation, this software calculates values near geographic poles, e.g. for latitudes higher than 89.999 and -89.999. This is the same approach the reference FORTRAN implementaion does have. Be adviced that near pole values are much less accurate.
There are far more than 1000+ unittests and results are compared against those generated from FORTRAN. SV values are not covered with tests due to the initial low accuracy of FORTRAN values. For most values these tolerances are used (whichever is higher):
- relative tolerance: 0.005
- absolute tolerance: 0.15
- absolute tolerance for declination and inclination: 0.005
Near pole values are tested with relaxed accuracies. Since FORTRAN rounds almost all values, except D and I, actual results are of much higher accuracy.
- Add
"github.com/proway2/go-igrf/igrf"to your import clause.
package main
import (
"fmt"
"github.com/proway2/go-igrf/igrf"
)
func main() {
igrf_data := igrf.New()
res, err := igrf_data.IGRF(46.9, 39.9, 0.0, 2021.5)
fmt.Println(res, err)
}- Run
go mod tidy, this brings the latest version. Fix the version atgo.modif you need a different one.