Calculate Earth's magnetic field at specific location and time using World Magnetic Model 2005 (WMM2005)
Environment/Gravity
The WMM2005 block implements the mathematical representation of the National Geospatial Intelligence Agency (NGA) World Magnetic Model 2005. The WMM2005 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).
You cannot use this block to model the Earth magnetic field above an altitude of 1,000,000 meters.
Specifies the input and output units:
Units | Height | Magnetic Field | Horizontal Intensity | Total Intensity |
---|---|---|---|---|
Metric (MKS) | Meters | Nanotesla | Nanotesla | Nanotesla |
English | Feet | Nanogauss | Nanogauss | Nanogauss |
When selected, the decimal year is an input for the World Magnetic Model 2005 block. Otherwise, a date must be specified using the dialog parameters of Month, Day, and Year.
Specifies the month used to calculate decimal year.
Specifies the day used to calculate decimal year.
Specifies the year used to calculate decimal year.
Specify if out-of-range input invokes a warning, error or no action.
When selected, the horizontal intensity is output.
When selected, the declination, the angle between true north and the magnetic field vector (positive eastwards), is output.
When selected, the inclination, the angle between the horizontal plane and the magnetic field vector (positive downwards), is output.
When selected, the total intensity is output.
Input | Dimension Type | Description |
---|---|---|
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,
%%%BEGIN CODE%%% dyear=decyear('21-March-2005','dd-mmm-yyyy') %%%END CODE%%% |
Output | Dimension Type | Description |
---|---|---|
First | Vector | Contains the magnetic field in selected units. The reference frame is north-east-down (NED). |
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. |
The WMM2005 specification produces data that is reliable five years after the epoch of the model, which is January 1, 2005.
The internal calculation of decimal year does not take into account local time or leap seconds.
The WMM2005 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.
World Magnetic Model 2005 will be removed in a future version. For model years between 2000 and the start of 2015, use International Geomagnetic Reference Field 12. For model years between 2015 and later, use World Magnetic Model.