Dane wejściowe z maszyn i czujników (0,38)
Czytniki, które wprowadzają do rodzaju receiver-trust inne odbiorniki, solwery i czujniki. Każdy jest tylko do odczytu: to czyste funkcje na bajtach lub tekście, które zwracają ten sam przebieg czasowy co czytniki UBX, RINEX, Android i NMEA, pomijając i zliczając uszkodzone rekordy zamiast kończyć się błędem. Wszystko tu jest MODELLED: formaty odczytano z dokumentacji publicznej, a żaden wynik nie jest zwalidowany względem zewnętrznej wyroczni poza tym, co podano.
Oprogramowanie wyłącznie doradcze. Nie jest to sprzęt nawigacyjny z zatwierdzeniem typu. Za bezpieczną nawigację statku odpowiada nadal operator.
RTKLIB .pos (format = "rtklib-pos")#
Plik rozwiązania zapisywany przez rnx2rtkp RTKLIB i RTKPOST. Odczytywane: czas (kalendarz yyyy/mm/dd hh:mm:ss.sss albo tydzień GPS i sekundy tygodnia), położenie (szerokość i długość geograficzna w stopniach z wysokością lub ECEF X/Y/Z przeliczone na geodezyjne) oraz liczba satelitów. Skala czasu w nagłówku kolumny (GPST, UTC, JST) jest przenoszona w etykiecie. Pliki ze stopniami-minutami-sekundami są odrzucane. Wiersze zaczynające się od % są wierszami nagłówka.
NovAtel OEM7 (format = "novatel")#
Dzienniki ASCII (#BESTPOSA,...*crc) i binarne (nagłówek AA 44 12), mieszane dowolnie. Układy zgodne z publiczną dokumentacją OEM7 (docs.novatel.com): nagłówki komunikatów, 32-bitowa CRC i tabele pól trzech dzienników. Rekordy, których CRC się nie zgadza, są pomijane i zliczane.
| Dziennik | ID | Użyte |
|---|---|---|
BESTPOS |
42 | status rozwiązania (tylko SOL_COMPUTED daje pozycję), szerokość, długość, wysokość nad średnim poziomem morza plus undulacja (wysokość pozycji jest elipsoidalna), liczba użytych satelitów |
RANGE |
43 | C/No na sygnał (dB-Hz); system z bitów 16-18 statusu śledzenia, typ sygnału z bitów 21-25 |
RXSTATUS |
93 | bit 15 statusu odbiornika (wykryto zagłuszacz) staje się self_report epoki (zagłuszanie 2 oznaczone, 1 nie; RXSTATUS nie ma flagi spoofingu), porównywanym z alarmami Kshana przez receiver-self-report; pomocnicze bity zagłuszaczy 1 (RF1-RF6) są zwracane w NovatelRead.status |
Procedurę CRC sprawdzono względem CRC, które dokumentacja podaje dla własnego przykładu BESTPOSA (zacytowane, nie przytoczone); testy używają samodzielnie napisanych wierszy. Nieczytane: skrócony ASCII, inne dzienniki. Flaga zagłuszacza jest własnym raportem odbiornika, a nie ustaleniem Kshana; zgodność z monitorami Kshana nie jest walidacją.
GNSS-SDR (format = "gnss-sdr")#
Zob. integrations/gnss-sdr/README.md. Wyjścia NMEA i RINEX z GNSS-SDR są już odczytywane przez nmea i rinex; strumienie UDP Monitor i PVT-monitor (Protocol Buffers) są przekazywane jako wiersze JSON przez relay.py i odczytywane przez gnss-sdr.
IMU ([log.imu])#
format = "csv": wiersz nagłówka z nazwami kolumn, następnie jedna próbka na wiersz. Kolumny (w dowolnej kolejności, nazwy bez rozróżniania wielkości liter): t_s sekundy na zegarze dziennika odbiornika, gx, gy, gz prędkość kątowa w rad/s, ax, ay, az siła właściwa w m/s². format = "euroc": układ EuRoC MAV imu0 data.csv (#timestamp [ns], w_RS_S_x/y/z [rad s^-1], a_RS_S_x/y/z [m s^-2]); pierwsza próbka to t_s = 0. Wiersze, których nie da się przetworzyć, oraz wiersze, w których czas nie rośnie, są pomijane. Zob. RECEIVER-TRUST.md, jak używany jest kurs z żyroskopu.
IMU w scenariuszach hybrid i fusion (kshana imu-fit)#
Scenariusze hybrid i fusion (UKF o 17 stanach) są symulacjami: przyjmują parametry szumu czujnika ([accel_quantum], [accel_classical]: bias, q_va, gyro_bias, q_arw, bias_instability), a nie zmierzony szereg. imu-fit odczytuje te parametry ze stacjonarnego dziennika IMU, więc scenariusz można uruchomić z faktycznie posiadanym czujnikiem:
kshana imu-fit still.csv --format csv --axis x --expected-mean 0 --id bench-imu # prints the TOML table
kshana imu-fit still.csv --axis z --expected-mean 9.80665 --json # whole report
Metoda: nakładające się odchylenie Allana scałkowanego sygnału (allan::overlapping_adev_curve): q_va = (sigma(tau0) sqrt(tau0))^2, to samo dla żyroskopu z (q_arw), bias i gyro_bias jako średnie oraz bias_instability jako minimum krzywej, gdy krzywa po nim rośnie. q_aa nie jest dopasowywane (wymaga dziennika znacznie dłuższego niż dolna granica). Raport zawiera częstość i rozpiętość dziennika oraz wczesne nachylenie Allana każdego kanału (około -0.5 tam, gdzie dominuje szum biały); dziennik, który nie jest nieruchomy, jest zbyt krótki (poniżej 2000 próbek) lub próbkowany nierównomiernie, jest odrzucany albo daje parametry oznaczone przez nachylenia. Pochodzenie tabeli podaje SHA-256 dziennika. MODELLED: estymator jest sprawdzony na syntetycznych dziennikach szumu białego ze znanymi współczynnikami (odtworzonymi z dokładnością do 10 %), a nie względem zewnętrznej wyroczni. Dostępne w CLI, Pythonie (imu_fit), WebAssembly (imu_fit), MCP (fit_imu_log) i we wtyczce (/kshana-fit-imu).
RTCM 3 MSM4 i MSM7 (format = "rtcm3")#
Strumień bajtów ramek RTCM 3 (wyjście obserwacji stacji bazowej lub odbiornika). Odczytywane: komunikaty MSM4 i MSM7 (GPS 1074/1077, GLONASS 1084/1087, Galileo 1094/1097, SBAS 1104/1107, QZSS 1114/1117, BeiDou 1124/1127, NavIC 1134/1137): epoka oraz stosunek nośnej do szumu każdej komórki sygnału (MSM4: 6 bitów, dB-Hz; MSM7: 10 bitów, 1/16 dB-Hz), czego potrzebują monitory C/N0. Pola pseudoodległości i fazy są przeskakiwane, a nie używane, więc RTCM dostarcza monitorom zaufania C/N0 i nic więcej; w MSM nie ma położenia. Ramki z błędnym CRC-24Q są pomijane i zliczane.
Skąd pochodzi układ. Nie ze standardu RTCM (płatny dokument, niekonsultowany): z otwartoźródłowego dekodera pyrtcm 1.2.0, BSD 3-Clause, którego licencja i nota znajdują się w NOTICE (decyzja właściciela z 18 paź 2026: „używać otwartych dekoderów”). pyrtcm podaje, że jego tabele odpowiadają RTCM 10403,3; Kshana opiera się na opublikowanych tabelach na licencji pyrtcm i nie składa żadnych deklaracji o standardzie. Czas: MSM nie zawiera tygodnia, więc etykiety odczytują GPS TOW <s>; epoki GLONASS (czas moskiewski) są przesuwane do czasu GPS z GPS-UTC = 18 s (wartość od 2017-01-01).
Sprawdzone względem: wartości kontrolnej katalogu CRC-24Q (123456789 daje 0xCDE703) oraz, jednorazowo w trakcie rozwoju, własnego dekodera pyrtcm na tych samych samodzielnie napisanych ramkach (to samo C/N0). Dane testowe są samodzielnie napisane; nie wykonano żadnego zapisu z prawdziwego odbiornika, więc czytnik jest MODELLED, dopóki jednego nie odczyta.