SuperAPI AI 工具集

analyze-wpilog

编程与开发

查看项目

更新于 10-16 06:21

技能介绍

用途:WPILOG 是 FRC 生态中日志库使用的二进制日志格式,analyze-wpilog 基于 wpilog-parser 库,帮助用 TS/JS 读取并分析这类日志文件。

主要能力:先用 pnpm wpilog catalog ./example.wpilog 列出日志中的条目,默认输出纯文本,也可用 --json、--jsonl/--ndjson 或 --csv 切换格式。分析时使用 parseDataLog 解析 DataLog 字节,可按 record.name 过滤并用 record.type 收窄类型;对 struct 类型记录可用 structPayloadToJson 转为 JSON。parseDataLog 支持 strict 选项,遇到孤立数据记录时抛出错误而非跳过。

使用方式:用 pnpm init 初始化项目并添加 wpilog-parser 依赖。读取文件后遍历 parseDataLog(bytes) 返回的记录,判断 isDataRecord 后处理。时间戳为微秒(bigint)。开启 DriverStation 日志时,日志包含 /DS:enabled、/DS:autonomous、/DS:test、/DS:estop 等布尔条目,可据此统计各模式启用时长;模式标志反映 DS 在启用时会运行的模式,需与 /DS:enabled 一起判断。

适用场景:FRC 机器人日志的离线分析、按条目筛选数据、解析位姿等 struct 数据、统计自动/手动/测试模式时长。

限制:资料未提供支持的平台、版本要求、性能上限或收费信息;具体 API 行为以库文档为准。