Aerospace Toolbox

VirtualRealityAnimation (Aero.VirtualRealityAnimation)

wrldmagm - Use World Magnetic Model

Syntax

[xyz, h, dec, dip, f] = wrldmagm(height, lat, lon, dyear) [xyz, h, dec, dip, f] = wrldmagm(height, lat, lon, dyear, '2005') [xyz, h, dec, dip, f] = wrldmagm(height, lat, lon, dyear, '2000')

Description

[xyz, h, dec, dip, f] = wrldmagm(height, lat, lon, dyear)calculates the Earth's magnetic field at a specific location and time using the World Magnetic Model (WMM). The default WMM is WMM-2005, which is valid from January 1, 2005, until December 31, 2009.

Inputs required by wrldmagm are:

`height`	A scalar value, in meters
`lat`	A scalar geodetic latitude, in degrees, where north latitude is positive, and south latitude is negative
`lon`	A scalar geodetic longitude, in degrees, where east longitude is positive, and west longitude is negative
`dyear`	A scalar decimal year. Decimal year is the desired year in a decimal format to include any fraction of the year that has already passed.

Outputs calculated for the Earth's magnetic field include:

`xyz`	Magnetic field vector in nanotesla (nT)
`h`	Horizontal intensity in nanotesla (nT)
`dec`	Declination in degrees
`dip`	Inclination in degrees
`f`	Total intensity in nanotesla (nT)

[xyz, h, dec, dip, f] = wrldmagm(height, lat, lon, dyear, '2005') is an alternate method for calling WMM-2005, or 2005 epoch.

[xyz, h, dec, dip, f] = wrldmagm(height, lat, lon, dyear, '2000') is the method for calling WMM-2000, or 2000 epoch.

Examples

Calculate the magnetic model 1000 meters over Natick, Massachusetts on July 4, 2005, using WMM-2005:

[XYZ, H, DEC, DIP, F] = wrldmagm(1000, 42.283, -71.35, 2005.5068 )


XYZ =

  1.0e+004 *

    1.8976
   -0.5167
    4.9555


H =

  1.9667e+004


DEC =

  -15.2324


DIP =

   68.3530


F =

  5.3315e+004

Assumptions and Limitations

The WMM specification produces data that is reliable five years after the epoch of the model, which begins January 1 of the model year selected. The WMM specification describes only the long-wavelength spatial magnetic fluctuations due to the Earth's core. Intermediate and short-wavelength fluctuations, contributed from the crustal field (the mantle and crust), are not included. Also, the substantial fluctuations of the geomagnetic field, which occur constantly during magnetic storms and almost constantly in the disturbance field (auroral zones), are not included.

References

http://www.ngdc.noaa.gov/seg/WMM/DoDWMM.shtml