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

yumaread

Чтение данных из файла альманаха YUMA.

Библиотека

EngeeNavigation

Синтаксис

Вызов функции

  • data = yumaread(filename) — считывает данные из файла альманаха YUMA, заданного аргументом filename, и возвращает параметры каждого соответствующего спутника в виде табличных данных data.

  • data = yumaread(filename,GPSWeekEpoch=refdate) — задает исходную дату, от которой в файле альманаха YUMA ведется отсчет номера недели в системе глобального позиционирования (Global Positioning System, GPS).

Аргументы

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

# filename — имя файла альманаха YUMA
строка

Details

Имя файла альманаха YUMA для чтения данных, заданное как строка. Имя файла может содержать абсолютный путь, относительный путь или не содержать пути вовсе. Имя файла также может включать расширение.

Типы данных

String

# GPSWeekEpoch — дата отсчета
"06-Jan-1980" | "21-Aug-1999" | "06-Apr-2019"

Details

Дата отсчета, заданная как строка формата DateTime, от которой в файле альманаха YUMA ведется отсчет номера недели по GPS.

Эти даты повторяются каждые 1024 недели, начиная с 6 января 1980 года в 00:00 (UTC). Значением по умолчанию является строка даты и времени, которая совпадает с последней датой переноса номера недели GPS перед текущим днем.

Типы данных

String

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

# data — параметры каждого спутника
табличные данные

Details

Параметры каждого спутника, возвращаемые в виде табличных данных, где каждая строка соответствует отдельной записи, а каждый столбец — параметру этой записи.

Параметры Тип данных Описание

Time

DateTime

Время по часам GPS, рассчитанное с помощью параметров Week и TimeOfApplicability

PRN

Float64

Номер псевдослучайного кода спутника

Health

Float64

Код состояния (исправности) спутника

Eccentricity

Float64

Эксцентриситет орбиты

TimeOfApplicability

Float64

Количество секунд с начала недели GPS

OrbitalInclination

Float64

Угол наклонения орбиты в момент отсчета, в радианах

RateOfRightAscen

Float64

Скорость изменения прямого восхождения, в рад/с

SQRTA

Float64

Квадратный корень из большой полуоси, в м1/2

RightAscenAtWeek

Float64

Географическая долгота плоскости орбиты на момент начала недели, в радианах

ArgumentOfPerigee

Float64

Угол от экватора до перигея, в радианах

MeanAnom

Float64

Угловое положение спутника на орбите относительно перигея, в радианах

Af0

Float64

Поправка нулевого порядка к показаниям часов спутника, в секундах

Af1

Float64

Поправка первого порядка к показаниям часов спутника, в секундах на секунду

Week

Float64

Номер недели GPS. Это непрерывный номер, не mod(1024)
Типы данных

DataFrame

Советы

Чтобы загрузить файлы альманаха YUMA с веб-сайта NAVCEN для текущей даты, необходимо указать дату, предшествующую текущей на два дня, поскольку момент применимости данных GPS наступает примерно через 70 часов после времени передачи набора данных альманаха.

Литература

  1. Science Applications International Corporation. NAVSTAR GPS Space Segment/Navigation User Interfaces. IS-GPS-200M. Los Angeles, CA: United States Space Force Space Systems Command, approved May 21, 2021. https://www.navcen.uscg.gov/sites/default/files/pdf/gps/IS_GPS_200M.pdf.

  2. Science Applications International Corporation. NAVSTAR GPS Space Segment/Navigation User Interfaces. ICD-GPS-240D. Los Angeles, CA: United States Space Force Space Systems Command, approved May 21, 2021. https://www.navcen.uscg.gov/sites/default/files/pdf/gps/ICD_GPS_240D.pdf.

  3. United States Coast Guard. GPS Almanacs, NANUs, and OPS Advisories Archives. US Coast Guard Navigation Center. Accessed May 6, 2022. https://www.navcen.uscg.gov/archives.

  4. Quasi-Zenith Satellite System(QZSS). Satellite Positioning, Navigation and Timing Service. Accessed September 20, 2022. https://qzss.go.jp/en/technical/download/pdf/ps-is-qzss/is-qzss-pnt-004.pdf.

  5. QZSS almanac archives, Quasi-Zenith Satellite System(QZSS). QZSS (Quasi-Zenith Satellite System) - Cabinet Office (Japan) Accessed September 20, 2022. https://sys.qzss.go.jp/dod/en/archives/pnt.html.