机器与传感器输入(0.38)
把其他接收机、解算器和传感器引入receiver-trust类型的读取器。每一个都是只读的:对字节或文本的纯函数,返回与UBX、RINEX、Android和NMEA读取器相同的时间线,对损坏的记录跳过并计数,而不是失败。这里的一切都是MODELLED:各格式依据公开文档读取,除所述内容外,没有任何结果对照外部参考基准(oracle)核对过。
仅供参考的软件。不是经型式认可的导航设备。船舶安全航行的责任仍由操作人员承担。
RTKLIB .pos(format = "rtklib-pos")#
RTKLIB的rnx2rtkp和RTKPOST写出的解文件。读取:时间(日历yyyy/mm/dd hh:mm:ss.sss,或GPS周和周内秒)、位置(以度为单位的经纬度加高度,或转换为大地坐标的ECEF X/Y/Z)以及卫星数。列标题中的时间系统(GPST、UTC、JST)写入标签。度分秒格式的文件被拒绝。以%开头的行为表头行。
NovAtel OEM7(format = "novatel")#
ASCII(#BESTPOSA,...*crc)和二进制(AA 44 12表头)日志,可任意混合。布局依据公开的OEM7文档(docs.novatel.com):消息头、32位CRC以及三种日志的字段表。CRC不匹配的记录被跳过并计数。
| 日志 | ID | 使用的内容 |
|---|---|---|
BESTPOS |
42 | 解状态(只有SOL_COMPUTED才给出定位解)、纬度、经度、平均海平面以上高度加大地水准面起伏(定位解高度为椭球高)、使用的卫星数 |
RANGE |
43 | 各信号的C/No(dB-Hz);系统取自跟踪状态位16-18,信号类型取自位21-25 |
RXSTATUS |
93 | 接收机状态位15(检测到干扰机)成为该历元的self_report(压制干扰标记为2,未标记为1;RXSTATUS没有欺骗干扰标志),由receiver-self-report与Kshana的告警对比;辅助的1个干扰机位(RF1-RF6)在NovatelRead.status中返回 |
CRC例程已对照文档为其自身BESTPOSA示例所给出的CRC进行检查(仅引用,未引述);测试使用自编的行。未读取:缩略ASCII和其他日志。干扰机标志是接收机自己的报告,不是Kshana的发现;与Kshana监测器一致并不构成验证。
GNSS-SDR(format = "gnss-sdr")#
参见integrations/gnss-sdr/README.md。GNSS-SDR的NMEA和RINEX输出已可用nmea和rinex读取;Monitor和PVT-monitor UDP流(Protocol Buffers)由relay.py转发为JSON行,并用gnss-sdr读取。
IMU([log.imu])#
format = "csv":一个命名各列的表头行,然后每行一个采样。列(顺序任意,名称不区分大小写):t_s为接收机日志时钟上的秒数,gx、gy、gz为角速率,单位rad/s,ax、ay、az为比力,单位m/s²。format = "euroc":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]);第一个采样为t_s = 0。无法解析的行以及时间不递增的行被跳过。陀螺航向的用法见RECEIVER-TRUST.md。
将IMU接入hybrid和fusion场景(kshana imu-fit)#
hybrid和fusion(17状态UKF)场景是仿真:它们接受传感器噪声参数([accel_quantum]、[accel_classical]:bias、q_va、gyro_bias、q_arw、bias_instability),而不是实测序列。imu-fit从静止IMU日志中读出这些参数,因此可以用您实际拥有的传感器运行场景:
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
方法:对积分信号求重叠Allan偏差(allan::overlapping_adev_curve):q_va = (sigma(tau0) sqrt(tau0))^2,z轴陀螺同理(q_arw),bias和gyro_bias取均值,当曲线在最小值之后上翘时bias_instability取曲线最小值。q_aa不做拟合(它需要远长于下限的日志)。报告带有日志的速率和跨度,以及各通道的早期Allan斜率(白噪声占主导时约为 -0.5);不静止、过短(少于2000个采样)或采样不均匀的日志,要么被拒绝,要么给出被斜率标出问题的参数。表的出处注明日志的SHA-256。MODELLED:该估计器在已知系数的合成白噪声日志上经过检验(恢复到10 % 以内),而不是对照外部参考基准(oracle)。可用于CLI、Python(imu_fit)、WebAssembly(imu_fit)、MCP(fit_imu_log)和插件(/kshana-fit-imu)。
RTCM 3 MSM4和MSM7(format = "rtcm3")#
RTCM 3帧的字节流(基站或接收机的观测输出)。读取:MSM4和MSM7消息(GPS 1074/1077、GLONASS 1084/1087、Galileo 1094/1097、SBAS 1104/1107、QZSS 1114/1117、BeiDou 1124/1127、NavIC 1134/1137):历元,以及每个信号单元的载噪比(MSM4:6位,dB-Hz;MSM7:10位,1/16 dB-Hz),这正是C/N0监测器所需要的。伪距和相位字段被跳过,不使用,因此RTCM只给信任度监测器提供C/N0,别无其他;MSM中没有位置。CRC-24Q错误的帧被跳过并计数。
布局的来源。不是来自RTCM标准(付费文件,未查阅):而是来自开源译码器pyrtcm 1.2.0,BSD 3-Clause,其许可和声明在NOTICE中(2026年十月18日的所有者决定:“use open decoders”)。pyrtcm声明其表遵循RTCM 10403.3;Kshana依赖pyrtcm许可下已发布的表,对该标准不作任何声明。时间:MSM不带周数,因此标签读作GPS TOW <s>;GLONASS历元(莫斯科时间)按GPS-UTC = 18 s(自2017-01-01起的值)换算为GPS时间。
已对照检查:CRC-24Q目录校验值(123456789给出0xCDE703),以及在开发期间一次性地用pyrtcm自己的译码器处理同样自编的帧(C/N0相同)。测试夹具为自编;没有取自真实接收机的采集数据,因此在读取过一份之前,该读取器为MODELLED。