IGRF Channel

Use the IGRF Channel option (IGRF GX) to compute the IGRF (International Geomagnetic Reference Field) or DGRF (Definitive Geomagnetic Reference Field) strength, inclination and declination from given longitude, latitude and optional elevation channels.

The option is available with the following extensions and menus:

  • Geophysics: IGRF > IGRF Channel
  • Geophysics Leveling: Tie Line Levelling > Levelling Corrections > IGRF Channel
  • UAV Merge Sorties: UAV Merge Sorties > Pre-processing > Remove IGRF

Compute IGRF Channels dialog options

IGRF / DGRF

Select "IGRF" or "DGRF" from the drop-down list.

If the survey is older than the last year that is a multiple of 5, select "DGRF".

See the Application Notes below for further details.

Script Parameter: IGRF.MODEL

IGRF model year (ignored for DGRF)

Select the model year. The default is "auto", which uses the most recent model year before current date.

See the Application Notes below for further details.

Script Parameter: IGRF.YEAR

Survey date

Specify the survey date using one of the options below:

  • Input the date as a string in the format yyyy/mm/dd
  • Select a channel from the drop-down list
  • Leave the field blank (the survey date of the line will be used) 
    On import, the line date is set to the date of the database creation, and you must reset it to the survey date.

See the Application Notes below for further details.

Script Parameter: IGRF.DATE

Input channels

Longitude

Select the longitude input channel. (The values should be between -180 to 180 degrees.)

Script Parameter: IGRF.LONG

Latitude

Select the latitude input channel. (The values should be between -90 to 90 degrees.)

Script Parameter: IGRF.LAT

Elevation

Specify the elevation using one of the options below:

  • Input a single numeric value
  • Select the input channel from the drop-down list

See the Application Notes below for further details.

Script Parameter: IGRF.ELEV

Output channels

Total field

Specify the output IGRF strength channel (nT).

Script Parameter: IGRF.TOTAL

Inclination

Specify the output IGRF inclination channel (degrees).

Script Parameter: IGRF.INC

Declination

Specify the output IGRF declination channel (degrees).

Script Parameter: IGRF.DEC

Application Notes

In source-free regions at the Earth's surface and above, the main field, with sources internal to the Earth, is the negative gradient of a scalar potential V which is represented by a 13th degree truncated series expansion (see International Geomagnetic Reference Field & International Geomagnetic Reference Field: the 12th generation):

Where:

A: Earth’s conventional mean reference spherical radius  6371.2 Km
N=13
r: radial distance at the designated longitude/latitude
θ: geocentric colatitude
φ: East longitude
 t: date
Pnm: Schmidt quasi-normalized associated Legendre function of degree n & order m
gnm & hnm: Gauss coefficients as function of time in units of nanotesla published by NOAA on 5 year increments

IGRF vs DGRF

The International Geomagnetic Reference Field (IGRF) is the empirical representation of Earth’s magnetic field as a function of time and in the absence of any crustal or external sources. The model employs the spherical harmonics expansion of the scalar potential in geocentric coordinates. The IGRF model coefficients are based on all available data sources including geomagnetic measurements from observatories, ships, aircrafts and satellites. For further details see ccmc.gsfc.nasa.gov.

The IGRF coefficients are reviewed and adjusted over time. The coefficients sets, for which no further changes are anticipated, are known as the Definitive Geomagnetic Reference Field (DGRF), and they should be used when the survey is older than the last year that is a multiple of 5.

If the IGRF model year is left as the default value ("auto"), the most recent model year before the current date is used in the computations. You may also specify a model year. If a survey crosses the year end of an IGRF model year (every five years), there will be a discontinuity in the calculated values across the year end. In this case, specify the model year as the start of the first 5-year period. This will force the use of the specified model for the entire survey.

The models are defined in ASCII files named IGRF.DAT and DGRF.DAT, located in the Oasis montaj \etc folder. For the IGRF models, the model is interpolated to the survey date using the secular variation coefficients in the IGRF.DAT file. For the DGRF models, the secular coefficients are calculated by interpolation between model years, and the required model date values are determined using these coefficients.

The new coefficients are appended to the DGRF table every five years. For backward compatibility, they are retained in the IGRF table.

If a date channel is selected, only the first date of each line in the database is the date used for the IGRF calculation. If the date changes within one database line, it is either due to using UTS time that occasionally may straddle over midnight, or because two line segments flown at different times may have been merged together. In the former case, the effect of straddling over midnight has virtually no effect on the IGRF calculation, as the IGRF field changes very slowly with time. In the latter case, you should break down the line into two lines using the date as the line break indicator.
In essence, two lines surveyed on different dates should not be merged into a single line even if they do align.

If you want to use an elevation channel, specify the channel name. Otherwise, the system assumes that the string in this parameter is a single real number value, and it uses the elevation as a constant in computing the IGRF channels. If the string cannot be converted into a valid number, the GX will not continue.

If you do not want to produce a specific output channel, leave the corresponding field blank.

The Technical Note "Out-of-Cycle Update of the US/UK World Magnetic Model for 2015-2020" contained information about the development and source data for the World Magnetic Model 2015-2020 Out of Cycle update. The coefficients were needed for surveys conducted between years 2015-2020. When the 2020 DGRF coefficients were released, the Out-of-Cycle coefficients were no longer needed; however, for backward compatibility they are available in the IGRF table.
The latest WMM (World Magnetic Model) coefficients are available for download from ngdc.noaa.gov.