主要内容

igrfmagm

利用国际地磁参考场计算地球磁场及其长期变化

折叠所有页面

语法

[XYZ,H,D,I,F,DXDYDZ,DH,DD,DI,DF] = igrfmagm(高度，纬度，经度，十进制年)
[XYZ,H,D,I,F,DXDYDZ,DH,DD,DI,DF] = igrfmagm(高度，纬度，经度，十进制年份，生成年份)

描述

例子

［XYZ，H，D，我，F，DXDYDZ，DH，DD，迪，DF= igrfmagm(高度，纬度，经度，decimalYear）利用国际地磁参考场第13代(IGRF-13)计算特定地点和时间的地球磁场及其长期变化。

［XYZ，H，D，我，F，DXDYDZ，DH，DD，迪，DF= igrfmagm(高度，纬度，经度，decimalYear，一代）可选地使用不同代的国际地磁参考场(IGRF-13、IGRF-12和IGRF-11)。

例子

全部折叠

使用IGRF-13计算2015年7月4日马萨诸塞州纳蒂克上空1000米的磁模型。

[XYZ, H, D, F).．.= igrfmagm(1000年,42.283,-71.35,decyear(2015、7、4),13)
XYZ = 1.0e+04 * 1.9471 -0.5086 4.8177 H = 2.0124e+04 D = -14.6381 I = 67.3295 F = 5.2212e+04

使用IGRF-13计算2018年5月15日在堪萨斯州劳伦斯上空0和10000公里处的磁模型。

h = [0,10000000] lat = [38.957114,38.957114] lon = [-95.253997，-95.253997] dyear = [decyear(2018,5,14)， decyear(2018,5,14)] [XYZ, h, D,I,F] = igrfmagm(h,lat,lon,dyear,13)
h = 0 10000000 latat = 38.9571 38.9571 lon = -95.2540 -95.2540 dyear = 1.0e+03 * 2.0184 2.0184 XYZ = 1.0e+04 * 2.00655 0.0783 4.7990 0.1192 0.0046 0.2571 h = 1.0e+04 * 2.00670 0.1193 D = 2.1714 2.1968 I = 66.6981 65.1016 F = 1.0e+04 * 5.2252 0.2834

输入参数

全部折叠

距离:到地球表面的距离，用矩阵、标量或矢量表示，单位为米

数据类型:双

大地纬度，以度表示为矩阵、标量或矢量。北纬为正，南纬为负。

此函数接受大于90且小于-90的纬度值。

数据类型:双

以度为单位，以矩阵、标量或矢量表示的大地经度。东经为正，西经为负。此函数接受大于180和小于-180的范围。

数据类型:双

年，十进制格式，指定为矩阵。这个值可以是已经过去的年份的任何部分。

数据类型:双

国际地磁参考场的生成版本，指定为13，12,或11．

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64|字符|字符串

输出参数

全部折叠

磁场矢量，以纳特斯拉(nT)为单位，返回为与输入矩阵相同大小的矢量或矩阵，只是增加了一个维度，即最后一个维度。矩阵的最后一个维度的大小为3，指定X，Y,Z磁场的分量。Z是竖直分量(+ve向下)这个矢量的分量在东北向下(NED)参考系中。

数据类型:双

水平强度，以标量、矢量或矩阵形式返回，单位为纳特斯拉(nT)，与输入矩阵大小相同。

数据类型:双

赤纬，返回为标量，度数(+ve向东)，与输入矩阵大小相同。

数据类型:双

倾斜，作为一个标量返回，以度为单位(+ve向下)，与输入矩阵的大小相同。

数据类型:双

总强度，以标量形式返回，单位为纳特斯拉(nT)，与输入矩阵大小相同。

数据类型:双

磁场矢量的长期变化，以矢量或矩阵的形式返回，单位为nT/年，与输入矩阵的相同大小，加上一个额外维度，即最后一个维度。矩阵的最后一个维度的大小为3，指定X，Y,Z磁场的分量。Z是竖直分量(+ve向下)

数据类型:双

水平强度的长期变化，以nT/年为单位，作为与输入矩阵相同大小的标量返回。

数据类型:双

赤纬的长期变化，分/年(东+ve)，作为一个标量返回，与输入矩阵的大小相同。

数据类型:双

倾斜的长期变化，分/年(+ve向下)，作为一个标量返回，与输入矩阵大小相同。

数据类型:双

总强度的长期变化，以nT/年为单位，作为与输入矩阵相同大小的标量返回。

数据类型:双

限制

  • 该函数适用于以下年份范围:

    • IGRF-13型- 1900和2025

    • IGRF-12型号- 1900和2020

    • IGRF-11型号- 1900和2015

  • 这个函数在-1000米和5.6地球半径(35,717,567.2米)之间有效。

  • 的高度，纬度，经度,decimalYear参数的大小必须相同(矩阵、标量等等)。

该函数具有国际地磁参考场(IGRF)的局限性。欲了解更多信息，请访问IGRF网站，https://www.ngdc.noaa.gov/IAGA/vmod/igrfhw.html．

参考文献

[1]布莱克利，r.j.。势理论在重磁应用中的应用．英国剑桥:剑桥大学出版社，1996年。

[2] Lowes, F. J.“国际地磁参考场:一个‘健康’警告。”2010年1月。https://www.ngdc.noaa.gov/IAGA/vmod/igrfhw.html．

版本历史

在R2015b中引入

另请参阅

|

外部网站