read

Считайте данные из GPS-приемника

Описание

пример

[tt,overrun] = read(gpsObj) возвращает показания GPS в timetable формат. Это - не чтение блокирования, которое возвращает точки данных N в формате расписания, где N задан by SamplesPerRead и timetable задан с помощью OutputFormat свойство gpsdev объект.

пример

[lla,groundSpeed,course, dops,gpsReceiverTime,timestamp, overrun] = read(gpsObj) возвращает матрицы измерений от GPS. Это - не чтение блокирования, которое возвращает точки данных N в матричном формате, где N задан SamplesPerRead и matrix задан с помощью OutputFormat свойство gpsdev объект.

Примеры

Считайте Данные из GPS как расписание

Создайте объект GPS с доступными свойствами.

g = gpsdev('COM4','OutputFormat','timetable','SamplesPerRead',2)

Считайте выборки GPS.

[tt,overruns] = read(g)
tt =

 2×5 timetable

              Time                         LLA                GroundSpeed    Course            DOPs                GPSReceiverTime     
    ________________________    __________________________    ___________    ______    ____________________    ________________________

    31-Jan-2020 11:32:49.459    12.944    77.692     806.8       0.0463      258.87    1.31    0.99    0.85    31-Jan-2020 06:02:49.000
    31-Jan-2020 11:32:50.416    12.944    77.692     806.9      0.12861       262.7    1.31    0.99    0.85    31-Jan-2020 06:02:50.000


overrun =

     0

Отобразите время, в которое данные о GPS считаны в duration формат.

g.TimeFormat = “duration”;
[tt,overruns] = read(g)
tt =

  2×5 timetable

       Time                  LLA                GroundSpeed    Course            DOPs                GPSReceiverTime     
    __________    __________________________    ___________    ______    ____________________    ________________________

    9.4257 sec    12.944    77.692     808.4     0.030867       4.93     1.51    0.78    1.29    31-Jan-2020 06:15:24.000
    10.404 sec    12.944    77.692     808.4     0.051444      41.26      1.1    0.76    0.79    31-Jan-2020 06:15:25.000

overrun =

     0

Считайте данные из GPS как матрица

Создайте объект GPS с доступными свойствами.

g = gpsdev('COM4', "OutputFormat","matrix",'SamplesPerRead',2);

Считайте выборки данных о GPS.

[lla,speed,course,dops,gpsReceiverTime,timestamp,overruns] = read(g)
lla =

   12.9437   77.6916  807.4000
   12.9437   77.6916  807.4000


speed =

    0.0154
    0.0463


course =

  346.0100
  270.2100


dops =

    1.2400    0.9200    0.8300
    1.7700    0.9900    1.4700


gpsReceiverTime = 

  2×1 datetime array

   31-Jan-2020 06:07:01.000
   31-Jan-2020 06:07:02.000


timestamp = 

  2×1 datetime array

   31-Jan-2020 11:37:01.734
   31-Jan-2020 11:37:02.436


overruns =

    0
	

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

свернуть все

Объект GPS со значением по умолчанию или заданными свойствами.

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

свернуть все

Данные читают из GPS-приемника, когда выходной формат установлен в timetable. timetable возвращенный имеет следующие поля:

  • LLA (широта, долгота, высота)

  • Скорость относительно земли

  • Курс по земле

  • Растворение точности (МЕДНЫЕ ЗАЖИМЫ), VDOP, HDOP, PDOP,

  • Время GPS-приемника

  • Время — Системное время, когда данные считаны в datetime или duration формат

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

Положение GPS-приемника в геодезической широте, долготе, и высоте (LLA), возвратилось как действительный конечный массив N-3. Широта и долгота в градусах с Севером и Востоком, являющимся положительным. Высота исчисляется в метрах.

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

Скорость по земле, возвращенной как действительный конечный вектор-столбец N-1.

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

Курс по земле относительно истинного севера, возвращенного как действительный конечный столбец N-1 значений между 0 и 2pi радианы.

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

Растворение точности, возвращенной как действительный конечный массив N-3. Порядком выхода является [PDOP,HDOP,VDOP].

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

Время UTC возвращено модулем GPS.

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

Время, в которое считаны данные о GPS, возвратилось как действительный конечный вектор-столбец N-1. Это - системное время. Если TimeFormat isdatetime, меткой времени будет datetime. Если TimeFormat duration, меткой времени будет duration

  • datetime — Отображает дату и время, в которой считаны данные.

  • duration — Отображается время протекло в секундах после первого вызова read функционируйте или последнее выполнение release функция.

Примечание

Если SamplesPerRead больше 1, экстраполяция сделана на временной стоимости. Следовательно это не может быть точно.

Типы данных: datetime | duration

Количество выборок, потерянных между последовательными вызовами read. Переполнение является нулем когда ReadMode установлен в oldest.

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

Больше о

свернуть все

read Вывод

gpsdev объект ожидает, что GPRMC, GPGGA и предложения GPGSA как выходные параметры от GPS-приемника получат необходимые значения. read функциональные ошибки, если эти предложения не доступны.

read функциональные выходные параметры NaN и NaT в следующих ситуациях:

  • Если модуль GPS не получает допустимые данные, потому что нет никакой спутниковой блокировки или когда GPS не дает особое значение.

  • Если будет несовпадение контрольной суммы, соответствующими точками данных будет NaN для числовых выходных параметров (lla, speed, course, dops) и NaT для gpsRecieverTime. lla взят из предложения GPGGA, speed, course, и gpsRecieverTime взят предложение GPRMC и dops взяты из предложения GPGSA.

Поскольку read функция не блокируется, следующее ожидается:

  • Если нет новых данных доступно, выход read предыдущие данные. Например, если задержка между последующими чтениями меньше UpdateRate из GPS-приемника.

Поскольку данные о GPS подтверждены в первом read операция, может потребоваться больше времени по сравнению с последующим read операции.

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