World Magnetic Model

Calculate Earth's magnetic field at specific location and time using World Magnetic Model

  • Library:
  • 航空航天块组/环境/重力

描述

World Magnetic Model块实现国家地理空间智能局(NGA)世界磁模型的数学代表。该World Magnetic Modelblock calculates the Earth magnetic field vector, horizontal intensity, declination, inclination, and total intensity at a specified location and time. The reference frame is north-east-down (NED).

Note

You cannot use this block to model the Earth magnetic field above an altitude of 1,000,000 meters.

限制

所有规格都有这些限制:

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

  • 该规范仅描述了地球核心中的长波长空间磁波动。不包括从地壳场(披风和地壳)的中间和短波波长波动。此外,不包括在磁风暴期间恒定地发生的地磁场的大大波动,并且在干扰场(极光区)中几乎不断地发生。

此外,每个规格都有这些限制:

  • WMM2015V2取代了WMM2015(V1)。当用于导航和其他系统时,考虑用WMM2015V2替换WMM2015(V1)。2019年2月,国家海洋和大气管理局(NOAA)释放了WMM2015v2,以纠正2015年1月1日至2019年12月31日的北极地区的绩效退化问题。因此,在系统中使用WMM2015(V1)仍然可以接受低于北半球的55度纬度。

  • 该WMM2015 specification produces data that is reliable five years after the epoch of the model, which is January 1, 2015.

  • 该WMM2010 specification produces data that is reliable five years after the epoch of the model, which is January 1, 2010.

  • 该WMM2005 specification produces data that is reliable five years after the epoch of the model, which is January 1, 2005.

  • WMM2000规范生产模型时期五年后的数据,该数据是2000年1月1日的。

港口

输入

expand all

在所选单元中指定为标量的高度。

Data Types:double

Latitude, specified as a scalar, in degrees.

Data Types:double

经度,指定为一个scalar, in degrees.

Data Types:double

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.

For example, to calculate the decimal year,dyear, for March 21, 2015:

dyear = decyear('21 -march-2015','dd-mmm-yyyy')
dyear = 2.0152e+03

Data Types:double

Output

expand all

磁场,在选定的单位中作为向量返回。

Data Types:double

Horizontal intensity, returned as a scalar, in specified units.

Data Types:double

Declination, returned as a scalar, in degrees.

Data Types:double

倾斜度,以标量返回,以学位。

Data Types:double

Total intensity, returned as a scalar, in selected units.

Data Types:double

Parameters

expand all

世界磁模型系数文件,选自列表。

  • WMM2000 (2000-2005)- 世界磁模型2000系数文件

  • WMM2005(2005-2010)— World Magnetic Model 2005 coefficient file

  • WMM2010(2010-2015)— World Magnetic Model 2010 coefficient file

  • WMM2015 V1(2015-2020)— World Magnetic Model 2015(v1) coefficient file

  • WMM2015 V2(2015-2020)— World Magnetic Model 2015v2 coefficient file

  • 习俗- 指定您自己的磁模型系数文件。您可以从中下载世界磁模型系数文件该NOAA World Magnetic Model.

Dependencies

Selecting习俗enables the自定义.cof文件parameter.

Programmatic Use

块参数:customfile.
Type:character vector
Values:'WMM2015 V2 (2015-2020)'|'WMM2000(2000-2005)'|'WMM2005 (2005-2010)'|'WMM2010 (2010-2015)'|'WMM2015 V1(2015-2020)'|'习俗'
Default:'WMM2015 V2 (2015-2020)'

World Magnetic Model coefficient file, downloaded from该NOAA World Magnetic Model. For example, if you want to download a coefficient file not yet listed in theWMM coefficients列表。

Dependencies

To enable this parameter, select习俗为了WMM coefficientsparameter.

Programmatic Use

块参数:customfile.
Type:character vector
Values:任何系数文件名
Default:'wmm2015v2.cof'

输入and output units:

单位 高度 Magnetic Field 水平强度 总强度
公制(MKS) Meters Nanotesla Nanotesla Nanotesla
英语 nanogauss. nanogauss. nanogauss.

Programmatic Use

块参数:单位
Type:character vector
Values:'公制(MKS)'|'English'
Default:'公制(MKS)'

选择时,小数年是一个输入World Magnetic Modelblock. Otherwise, specify a date using the dialog parameters ofMonth,,和Year.

Programmatic Use

块参数:time_in
Type:character vector
Values:'on'|'off'
Default:'on'

Month to calculate decimal year.

Programmatic Use

块参数:month
Type:character vector
Values:'一月'|'二月'|'游行'|'四月'|'May'|'June'|'七月'|'August'|'九月'|'October'|'十一月'|'December'
Default:'一月'

计算小数年的日子。

Programmatic Use

块参数:
Type:character vector
Values:'1'to'31'
Default:'1'

年度计算十进制年。

Programmatic Use

块参数:year
Type:character vector
Values:any year
Default:'2015'

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

Programmatic Use

块参数:action
Type:character vector
Values:'错误'|'Warning'|'None'
Default:'错误'

选择时,输出水平强度。

Programmatic Use

块参数:h_out
Type:character vector
Values:'on'|'off'|'None'
Default:'on'

当选择时,偏角或真北和磁场矢量(正向东)之间的角度被输出。

Programmatic Use

块参数:dec_out
Type:character vector
Values:'on'|'off'|'None'
Default:'on'

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

Programmatic Use

块参数:inc_out
Type:character vector
Values:'on'|'off'|'None'
Default:'on'

选择时,输出总强度。

Programmatic Use

块参数:ti_out.
Type:character vector
Values:'on'|'off'|'None'
Default:'on'

Introduced in R2019b