Skip to content

docs(tools): 收录 PlotJuggler 以支持 ROS 时序数据可视化分析 - #676

Merged
xy18574557330 merged 1 commit into
OpenHUTB:masterfrom
useruseruser452:docs_add_plotjuggler
Nov 17, 2026
Merged

xy18574557330 merged 1 commit into
OpenHUTB:masterfrom
useruseruser452:docs_add_plotjuggler

Conversation

@useruseruser452

Copy link
Copy Markdown
Contributor

修改原因

OpenHUTB 的 ROS 学习与仿真流程经常需要同时对比传感器、状态估计和控制器输出。现有工具列表缺少面向时序数据的交互式可视化工具,因此补充 PlotJuggler,便于实时查看 ROS 1/ROS 2 话题、回放数据并定位控制与感知问题。

修改内容

复现与验证

  • 环境:Windows 11、Python 3.11、MkDocs 1.6.1。
  • mkdocs build 成功,页面数为 26。
  • 已使用 mkdocs serve --livereload 预览 /.github/tools/,PlotJuggler 条目显示正常。
  • 文件保存为 UTF-8,无问号或替换字符。

运行效果

PlotJuggler 的 MkDocs 页面预览

提交前检查

  • 仅修改 docs/tools.md,无关文件。
  • 使用 MkDocs 预览并确认链接和中文显示正常。
  • 无硬编码目录、本机 IP 或绝对路径。
  • PNG 效果图小于 3 MB,文件名为英文下划线形式。

大模型使用声明

本次文档整理由 AI 辅助完成;已核对项目官网、源码、许可证、仓库重复情况和页面渲染效果,并对提交内容负全部责任。

@huba-bh

huba-bh commented Nov 14, 2026

Copy link
Copy Markdown
Contributor

审核通过

已基于最新提交 641fdce 完成复核:

  • python -m unittest discover -s tests -v:21 项测试全部通过。
  • MkDocs 1.6.1 完整构建成功,共生成 26 个 Markdown 文档;GitHub Actions 的 Build docs and run hook tests 检查为 success。
  • git diff --check 无格式错误。
  • PlotJuggler 官网与源码仓库均可访问;源码约 6.3k stars,近期仍有提交,许可证为 MPL-2.0,符合工具列表的收录标准。
  • 新增条目位于“开发”节,中文说明、链接与页面布局渲染正常。

页面效果

PlotJuggler 的 MkDocs 页面预览

@L269109

L269109 commented Nov 16, 2026

Copy link
Copy Markdown
Contributor

有冲突
Snipaste_2026-11-16_08-05-07

@zh-yutong

Copy link
Copy Markdown
Contributor

本次PR合理,新增PlotJuggler条目契合OpenHUTB ROS学习、仿真调试的需求,弥补了时序交互可视化工具的空缺。
提交内容规范:写明修改原因、官网/源码链接、MPL-2.0许可证,同时附上了完整的验证环境与编译结果,确认文档渲染正常、编码无乱码。工具本身社区成熟、对ROS支持良好,同意并入文档。

基于最新 master 重建单文件分支,保留已验证的工具条目并消除合并冲突。
@xy18574557330
xy18574557330 merged commit f70b123 into OpenHUTB:master Nov 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants