# 飞行日志分析

本主题概述了可用于分析 PX4 飞行日志的方法和软件包。

# 报告航班

飞行报告解释了如何下载日志并与开发团队报告/讨论有关飞行的问题。

# 结构化分析

在分析飞行日志之前，必须确定其背景：

如果分析是在故障发生后进行的，那么日志是否记录了坠机过程，还是在空中停止了？
所有控制器是否都跟踪了它们的参考点？最简单的方法是将姿态滚动和俯仰率与其设定点进行比较。
传感器数据看起来有效吗？是否有非常强烈的振动（强烈振动的合理阈值是峰峰值超过 2-3 m/s/s）。
如果根本原因与载具无关，请务必在报告时附上日志文件链接（如果有视频文件，请附上视频链接），并将其放在 PX4 问题跟踪器 (打开新窗口）.

# 排除电力故障

如果日志文件在空中终止，可能有两个主要原因：电源故障或操作系统的硬故障。

在基于 STM32 系列 (打开新窗口）操作系统的硬故障会被记录到 SD 卡中。这些故障位于 SD 卡的顶层，名称为 fault_date.log例如 fault_2017_04_03_00_26_05.log.如果飞行日志突然结束，请务必检查该文件是否存在。

# 分析工具

# 飞行审查（在线工具）

飞行回顾 (打开新窗口）是 原木粉碎机.它与新的 ULog 记录格式。

主要功能

基于网络，非常适合最终用户。
用户可以上传、加载报告，然后与他人共享。
交互式绘图。

飞行回顾图

参见使用飞行回顾进行日志分析的介绍。

# pyulog

pyulog (打开新窗口）是一个用于解析 ULog 文件的 python 软件包，还有一套命令行脚本用于提取/显示 ULog 信息并将其转换为其他文件格式。

主要功能

解析 ULog 文件的 Python 库。许多其他 ULog 分析和可视化工具使用的基础库。
提取/显示 ULog 信息的脚本：
- ulog_info显示 ULog 文件中的信息。
- ulog_messages显示 ULog 文件中的记录信息。
- ulog_params从 ULog 文件中提取参数。
将 ULog 文件转换为其他格式的脚本：
- ulog2csv：将 ULog 转换为（多个）CSV 文件。
- ulog2kml将 ULog 转换为（多个）KML 文件。

所有脚本都作为系统范围内的应用程序安装（也就是说，只要安装了 Python，就可以通过命令行调用），并支持 -h 标记来获取使用说明。例如

$ ulog_info -h usage: ulog_info [-h] [-v] file.ulg Display information from an ULog file positional arguments: file.ulg ULog input file optional arguments：-h，--help 显示帮助信息并退出 -v，--verbose 冗余输出

下面我们看到的是从示例文件中导出的信息类型，使用了 ulog_info.

$ ulog_info sample.ulg 记录开始时间：0:01:52，持续时间：0:01:08 Dropouts: count：4, total duration：0.1 s, max：62 ms, mean：29 ms Info Messages: sys_name: PX4 time_ref_utc：0 ver_hw：AUAV_X21 ver_sw：fd483321a5cf50ead91164356d15aa474643aa73 名称（多id，报文大小（字节）） 数据点数，总字节数 actuator_controls_0 (0, 48) 3269 156912 actuator_outputs (0. 76) 1311 99636 commander_controls_0 (0, 48) 3269 156912 actuator_outputs (0. 76) 1311 99636 commander_outputs (0. 76)76) 1311 99636 commander_state （0，9） 678 6102 control_state （0，122） 3268 398696 cpuload （0，16） 69 1104 ekf2_innovations （0，140） 3271 457940 estimator_status （0、309) 1311 405099 传感器组合 (0, 72) 17070 1229040 传感器预飞行 (0, 16) 17072 273152 遥测状态 (0, 36) 70 2520 载具姿态 (0, 36) 6461 232596 载具姿态设定点 (0, 55) 3272 179960 载具本地位置 (0, 123) 678 83394 载具速率设定点 (0, 24) 6448 154752 载具状态 (0, 45) 294 13230