PyULog 完整指南:把 ULog 飞行日志快速变成 CSV

发布时间:2026/8/22 15:21:51
PyULog 完整指南:把 ULog 飞行日志快速变成 CSV PyULog 完整指南把 ULog 飞行日志快速变成 CSV【免费下载链接】pyulogPython module scripts for ULog files项目地址: https://gitcode.com/gh_mirrors/py/pyulog无人机摔机后你抓到的第一个文件往往是个 .ulg 日志用十六进制编辑器打开全是乱码。PyULog 是一个解析 PX4 飞行日志的 Python 工具包把这些自描述的二进制日志变成你能直接读的数据。下次面对看不懂的文件从这里开始。PyULog 是什么PyULog 是面向无人机开发者、科研人员做 ULog 日志解析的 Python 库加命令行工具集。它把 ULog 文件读进来输出你能直接消费的数据CSV、KML、ROS2 bag或者存进 SQLite。ULog 是自描述格式消息结构写在文件里不需要你配 schema而且它不止是跑脚本你可以直接 import 进自己的分析管线。能力速览✅ 二进制日志解析 — 解码 ULog 文件结构不用配 schema还能检测丢包和文件损坏 ✅ 多格式导出 — ULog 转 CSV、KML、ROS2 bag 一键完成 ✅ 参数与事件提取 — 拉出飞行参数、错误消息、PX4 事件日志 ✅ 数据库存储 — DatabaseULog 存进 SQLite批量查询历史飞行三步跑起来第一步拿到代码克隆仓库git clone https://gitcode.com/gh_mirrors/py/pyulog第二步以可编辑模式安装依赖只有 numpycd pyulog pip install -e .第三步跑一个最小命令用的是仓库自带的样例日志ulog_info test/sample.ulg怎么判断装好了输出第一行看到Logging start time: 0:01:52, duration: 0:01:08下面跟着一长串消息类型和数据点数量就说明解析成功了。批量导出飞行数据挖出关键事件一条命令把 ULog 转成 CSVulog2csv是出场率最高的脚本把记录的数据转成 CSVpandas、表格软件直接能读还能用-m只导出你要的 topiculog2csv test/sample.ulg -m sensor_combined,vehicle_gps_position什么时候用想把传感器数据交给统计脚本或训练管线时只导出需要的 topic文件小、加载快。核心解析逻辑在 pyulog/core.py转换实现在 pyulog/ulog2csv.py。用 Python 挖出单个传感器的消息extract_message按名字取指定消息的全部数据还能按时间范围过滤返回的是字典列表接 pandas 很顺手from pyulog.extract_message import extract_message rows extract_message(test/sample.ulg, sensor_combined) print(len(rows))什么时候用你想自己做清洗、画图或建模需要脚本里精细控制而不是在 shell 里一把梭。源码在 pyulog/extract_message.py。真实场景怎么用 飞行异常排查三分钟定位传感器报错问题飞机摔了做 PX4 飞行日志分析第一反应是怀疑传感器掉线但不知道从哪查起。你做的操作跑ulog_messages把这次飞行记录的所有错误消息按时间打出来。得到的结果ERROR: [sensors] no barometer found这样的行直接出现气压计什么时候失效一目了然。️ 轨迹复盘肉眼翻坐标表不可能问题想确认飞行轨迹有没有飘但对着数据表翻来翻去太慢。你做的操作用ulog2kml把 GPS 位置数据转成 KML先装simplekml依赖。得到的结果在 Google Earth 里打开生成的文件整条飞行路径按高度变化着色画出来。避坑 进阶输出格式怎么选统计和机器学习用 CSV轨迹可视化用 KML要接机器人管线就用 ROS2 bag。大文件怎么不爆内存用-m只保留需要的消息类型超长日志用 Python API 按时间范围过滤别整个加载。批量处理怎么做先跑ulog_migratedb建表再用DatabaseULog把多个 .ulg 存进 SQLite跨日志查询。常见报错怎么查文件损坏、丢包先看ulog_info输出的 dropouts 统计KML 转换报缺依赖通常是忘了装 simplekml。PyULog 解决的就是日志读不了这件事一条命令把数据拿到手。现在去 clone 下来把上面的命令亲手跑一遍吧。【免费下载链接】pyulogPython module scripts for ULog files项目地址: https://gitcode.com/gh_mirrors/py/pyulog创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻