Accelerating the pace of engineering and science

# Documentation Center

• Trial Software

# World Magnetic Model 2000

Calculate Earth's magnetic field at specific location and time using World Magnetic Model 2000 (WMM2000)

 Note:   World Magnetic Model 2000 will be removed in a future version. For model years between 2000 and the start of 2010, use International Geomagnetic Reference Field 11. For model years between 2010 and the start of 2015, use World Magnetic Model 2010.

## Library

Environment/Gravity

## Description

The WMM2000 block implements the mathematical representation of the National Geospatial Intelligence Agency (NGA) World Magnetic Model 2000. The WMM2000 block calculates the Earth's magnetic field vector, horizontal intensity, declination, inclination, and total intensity at a specified location and time. The reference frame is north-east-down (NED).

## Dialog Box

Units

Specifies the input and output units:

UnitsHeightMagnetic FieldHorizontal IntensityTotal Intensity
Metric (MKS)MetersNanoteslaNanoteslaNanotesla
EnglishFeetNanogaussNanogaussNanogauss

Input decimal year

When selected, the decimal year is an input for the World Magnetic Model 2000 block. Otherwise, a date must be specified using the dialog parameters of Month, Day, and Year.

Month

Specifies the month used to calculate decimal year.

Day

Specifies the day used to calculate decimal year.

Year

Specifies the year used to calculate decimal year.

Action for out of range input

Specify if out-of-range input invokes a warning, error or no action.

Output horizontal intensity

When selected, the horizontal intensity is output.

Output declination

When selected, the declination, the angle between true north and the magnetic field vector (positive eastwards), is output.

Output inclination

When selected, the inclination, the angle between the horizontal plane and the magnetic field vector (positive downwards), is output.

Output total intensity

When selected, the total intensity is output.

## Inputs and Outputs

InputDimension TypeDescription

First

Contains the height, in selected units.

Second

Contains the latitude in degrees.

Third

Contains the longitude in degrees.

Fourth (Optional)

Contains the desired year in a decimal format to include any fraction of the year that has already passed. The value is the current year plus the number of days that have passed in this year divided by 365.

The following code illustrates how to calculate the decimal year, dyear, for March 21, 2005:

```%%%BEGIN CODE%%%
dyear=decyear('21-March-2005','dd-mmm-yyyy')
%%%END CODE%%%```

OutputDimension TypeDescription

First

Contains the magnetic field vector in selected units.

Second (Optional)

Contains the horizontal intensity in selected units.

Third (Optional)

Contains the declination in degrees.

Fourth (Optional)

Contains the inclination in degrees.

Fifth (Optional)

Contains the total intensity in selected units.

## Limitations

The WMM2000 specification produces data that is reliable five years after the epoch of the model, which is January 1, 2000.

The internal calculation of decimal year does not take into account local time or leap seconds.

The WMM2000 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.

## Reference

Macmillian, S. and J. M. Quinn, 2000. "The Derivation of the World Magnetic Model 2000," British Geological Survey Technical Report WM/00/17R.

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