igrfmagm

Вычислите магнитное поле Земли и световые изменения с помощью Международного Геомагнитного Опорного Поля

Свернуть все на странице

Синтаксис

[XYZ,H,D,I,F,DXDYDZ,DH,DD,DI,DF] = igrfmagm(height,latitude,longitude,decimalYear)
[XYZ,H,D,I,F,DXDYDZ,DH,DD,DI,DF] = igrfmagm(height,latitude,longitude,decimalYear,generation)

Описание

пример

[XYZ,H,D,I,F,DXDYDZ,DH,DD,DI,DF] = igrfmagm(height,latitude,longitude,decimalYear) вычисляет магнитное поле Земли и светское изменение в определенном месте и времени, используя генерацию 13 Международного геомагнитного опорного поля (IGRF-13).

[XYZ,H,D,I,F,DXDYDZ,DH,DD,DI,DF] = igrfmagm(height,latitude,longitude,decimalYear,generation) опционально использует различные поколения Международного геомагнитного опорного поля (IGRF-13, IGRF-12 и IGRF-11).

Примеры

свернуть все

Вычислите магнитную модель 1000 метров над Натиком, штат Массачусетс, 4 июля 2015 года с помощью IGRF-13.

[XYZ,H,D,I,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

Вычислите магнитную модель на 0 и 10000 км над Лоуренсом, штат Канзас, 15 мая 2018 года с помощью IGRF-13.

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

lat =
   38.9571   38.9571

lon =
  -95.2540  -95.2540

dyear =
   1.0e+03 *
    2.0184    2.0184

XYZ =
   1.0e+04 *

    2.0655    0.0783    4.7990
    0.1192    0.0046    0.2571

H =
   1.0e+04 *

    2.0670
    0.1193

D =
    2.1714
    2.1968

I =
   66.6981
   65.1016

F =
   1.0e+04 *

    5.2252
    0.2834

Входные параметры

свернуть все

Расстояние от поверхности Земли, заданное в виде матрицы, скаляра или вектора, в метрах.

Типы данных: double

Геодезическая широта, заданная в виде матрицы, скаляра или вектора, в степенях. Северная широта положительная, южная - отрицательная.

Эта функция принимает значения широты больше 90 и меньше -90.

Типы данных: double

Геодезическая долгота, заданная в виде матрицы, скаляра или вектора, в степенях. Восточная долгота положительная, западная - отрицательная. Эта функция принимает области значений, большие 180 и меньшие -180.

Типы данных: double

Год, в десятичном формате, задается как матрица. Это значение может иметь любую долю года, которая уже прошла.

Типы данных: double

Версия генерации Международного геомагнитного эталонного поля, заданная как 13, 12, или 11.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char | string

Выходные аргументы

свернуть все

Вектор поля, в нанотесле (nT), возвращается в виде вектора или матрицы того же размера, что и входная матрица с дополнительной размерностью, последней размерностью. Последняя размерность матрицы имеет размер 3, задавая X, Y и Z компоненты магнитного поля. Z - вертикальный компонент (+ ve вниз). Компоненты этого вектора находятся в северо-восточной-понижающей (NED) опорной системе координат.

Типы данных: double

Горизонтальная интенсивность, возвращенная в виде скаляра, вектора или матрицы, в нанотесле (nT), тот же размер, что и входная матрица.

Типы данных: double

Склонение, возвращаемое как скаляр, в степенях (+ ve восток), тот же размер, что и входная матрица.

Типы данных: double

Наклон, возвращенный как скаляр, в степенях (+ ve вниз), тот же размер, что и входная матрица.

Типы данных: double

Общая интенсивность, возвращенная в виде скаляра, в нанотесле (nT), тот же размер, что и входная матрица.

Типы данных: double

Светское изменение вектора магнитного поля, возвращаемое в виде вектора или матрицы, в nT/год, такой же размер ans и матрицы входа с дополнительной размерностью, последней размерностью. Последняя размерность матрицы имеет размер 3, задавая X, Y и Z компоненты магнитного поля. Z - вертикальный компонент (+ ve вниз).

Типы данных: double

Светское изменение горизонтальной интенсивности, в нТ/год, возвращается в виде скаляра, того же размера, что и входная матрица.

Типы данных: double

Светское изменение склонения, в минутах/году (+ ve восток), возвращается в виде скаляра, того же размера, что и входная матрица.

Типы данных: double

Светское изменение наклона, в минутах/году (+ ve вниз), возвращается как скаляр, того же размера, что и входная матрица.

Типы данных: double

Светское изменение общей интенсивности, в нТ/год, возвращается в виде скаляра, того же размера, что и входная матрица.

Типы данных: double

Ограничение

  • Эта функция действительна для этого года области значений:

    • IGRF-13 модель - 1900 и 2025 годы

    • IGRF-12 модель - 1900 и 2020

    • IGRF-11 модель - 1900 и 2015

  • Эта функция действительна между высотами -1000 м и 5,6 радиусами Земли (35, 717, 567. 2 м).

  • The height, latitude, longitude, и decimalYear аргументы должны быть совпадающими по размеру (матрица, скаляр и т.д.).

Эта функция имеет ограничения Международного геомагнитного эталонного поля (IGRF). Для получения дополнительной информации смотрите веб-сайт IGRF, https://www.ngdc.noaa.gov/IAGA/vmod/igrfhw.html.

Ссылки

[1] Blakely, R. J. Potential Theory in Gravity & Magnetic Applications. Кембридж, Великобритания: Cambridge University Press, 1996.

[2] Lowes, F. J. «The International Geomagnetic Reference Field: A 'Health' Warning». Январь 2010 года. https://www.ngdc.noaa.gov/IAGA/vmod/igrfhw.html.

См. также

|

Внешние веб-сайты

Введенный в R2015b

Документация Aerospace Toolbox

Поддержка

Для просмотра документации необходимо авторизоваться на сайте