Repository navigation
ground: 合入 #1246/#1249/#1250/#1252/#1254 五个模块,并补齐导航与 CI 挂接 - #1277
xingwunian wants to merge 38 commits into
Conversation
Add tire_slip_curve module
Added a new section on energy consumption and range during driving cycles.
新增 tire_slip_curve,把「轮胎附着随滑移率变化」做成可离线校验的曲线与 ABS 目标带 # Conflicts: # docs/index.md # mkdocs.yml
新增 rollover_margin,把「侧翻裕度」做成可离线校验的载荷转移与极限车速核算 # Conflicts: # docs/index.md # mkdocs.yml
新增 drive_cycle_energy,把「工况能耗与续航」做成可离线复算的能量分解 # Conflicts: # docs/index.md # mkdocs.yml
新增 lateral_stability_margin,把「不足转向」做成可离线校验的稳态转向角与稳定裕度核算 # Conflicts: # docs/index.md # mkdocs.yml
…ibility 新增 ride_comfort_transmissibility,把「乘坐舒适性」做成可离线校验的传递率曲线与等级判定 # Conflicts: # docs/index.md
tire_slip_curve / rollover_margin / drive_cycle_energy / ride_comfort_transmissibility / lateral_stability_margin 的本地自检 此前没有任何 workflow 会跑(air_bridge_tests 只跑固定文件名, ground_planner_tests 只覆盖带 ci/run_ci.sh 的两个模块)。 新增 matrix 任务逐个执行 tests/test_<module>_local.py。
|
我按 PR 描述把 5 个模块的离线自测全跑了一遍,并把文档里的关键数值逐项复算对照。结论先说:测试全绿、数值和文档一致;但发现 1 个公式错配、1 个合并冲突(已在当前 master 上复现)。 一、我实际跑过的共 706 项断言,Python 3.13.14 / numpy 2.5.4,不需要 ROS,全部通过。 核心数值复算与文档一致:SSF 二、需要处理的两个问题1.
|
| ζ | 代码 peak_ratio / peak_value |
闭式真值 | 数值扫描 | 峰值低估 |
|---|---|---|---|---|
| 0.10 | 0.989949 / 5.122736 | 0.990334 / 5.122774 | 0.990400 / 5.122772 | 0.001% |
| 0.25 | 0.935414 / 2.280351 | 0.948145 / 2.283153 | 0.948200 / 2.283153 | 0.12% |
| 0.40 | 0.824621 / 1.633904 | 0.892650 / 1.655047 | 0.892600 / 1.655047 | 1.28% |
| 0.60 | 0.529150 / 1.233924 | 0.820642 / 1.352758 | 0.820600 / 1.352758 | 8.79% |
默认 ζ=0.25 时误差只有 0.12%,所以 check_ride(peak_tolerance=0.05) 一直能过;但 RideSpec 本身允许 ζ 到 1/√2,到 ζ=0.6 时峰位差 35%、峰值低估 8.8%,两条断言给出的就是错误结论了。
另外 docs/ground/ride_comfort_transmissibility.md 第 45 行写的"真正的极值在 r_p = 0.935,峰值 2.280,高出约 2%。阻尼越大偏得越多"——这个"2% 偏差"不是数值误差,而是公式错配本身:闭式解 0.948145 其实和你们扫描出来的 0.948625 是一致的(差在 0.0099 的扫描步长)。建议 peak_ratio() 换成上面的位移传递率闭式解,文档那段描述同步改掉。
2. mkdocs.yml / docs/index.md 合并会冲突(已在当前 master 上复现)
你们 5 行导航挂在 里程计健康监视 之后,但 master 现在这两行已经没了。当前 master 的地面段尾是:
- 速度指令安全监督: './ground/cmd_vel_guard.md'
# ← 空行
- 空域载具:我用三方合并复现(base = head 去掉新增的 5 行,ours = head,theirs = 当前 master):
$ git merge-file -p --diff3 mkdocs.ours mkdocs.base mkdocs.theirs
<<<<<<< ours
- VRU 冲突风险图: './ground/vru_conflict_risk_map.md'
- 里程计健康监视: './ground/odom_health_monitor.md'
- 乘坐舒适性传递率: './ground/ride_comfort_transmissibility.md'
...
=======
>>>>>>> master
docs/index.md 情况一样(VRU 冲突风险图、里程计健康监视 两条 bullet 在 master 上也没了),同样冲突。
建议把插入点换到 master 上确实存在、且不在段尾的锚点(例如紧跟 - 地面载具: 段首之后),或者干脆把导航/首页这两处从本 PR 拆出去单独提。mkdocs.yml 近两天有 30+ 次提交,段尾是所有人都在抢的位置,插在段尾迟早要冲突。
三、其余建议
-
energy_core.parse_segments()不校验跨段连续性(P2):只检查段内(t, v0, v1),不检查v1(i)和v0(i+1)是否衔接。断点处的动能跳变不会进ke_j,所以"能量分解自洽"照样 PASS,但物理上少了一整块能量。我用[(10,0,50),(10,50,50),(10,0,50)]试了一下:恒等式残差0.000 J,可两次从 0 起步隐含的动能变化是2 × 173.6 kJ,报告里完全看不到。建议加连续性校验(容差 1e-9),或把断点动能显式计入。 -
CI 建议加
workflow_dispatch(P3):ground_module_tests.yml只有push/pull_request的paths过滤。如果这个 check 以后被设成必需检查,只改 docs 的 PR 会一直 pending(或被直接跳过变成 pass),两种情况都不好排查。 -
5 个模块都是
catkin+rospy+ ROS 1launch(package.xml还是 format 2),而仓库是 ros2。如果是有意保持 ROS 1 兼容,建议在 README 里写明;否则建议统一到 ament/rclpy,不然合并后仓库里会多 5 个在 ROS 2 环境下起不来的包。 -
rollover_margin/package.xml的 maintainer 是个人 QQ 邮箱,别的模块是maintainer@example.com,建议统一成一个真实可用的联系方式。
@xingwunian 第 1、2 条建议合并前处理(第 2 条是硬阻塞),其余可以后续跟进。需要我把冲突那块解掉、或者补一个连续性校验的改动,直接说。
这个 PR 做了什么
把 #1246 / #1249 / #1250 / #1252 / #1254 五个 ground 模块原样合入(保留各自作者的提交与 merge commit),
再补上三个缺的挂接动作。相对当前 master 只有新增(+6921 / -0),没有删除任何行。
为什么不能直接点这五个 PR 的 Merge
五个分支都基于较旧的 master,各自相对 master 少了 12~19 条已合并入口(
docs/index.md、mkdocs.yml,例如「VRU 冲突风险图」「里程计健康监视」「ROS2 A*+DWA…」等)。直接合并会把那些已上线页面从文档站入口里删掉,
#1254 的 review(jiaohua745-blip)已经指出过这个问题。
本 PR 做的三件事
docs/index.md与mkdocs.yml都以当前 master 为底,只在「里程计健康监视」后面插入本模块一行,所以不会有任何已合并条目丢失:
./ground/tire_slip_curve.md./ground/rollover_margin.md./ground/drive_cycle_energy.md./ground/ride_comfort_transmissibility.md./ground/lateral_stability_margin.mdfeat(ground): 新增 tire_slip_curve,把「轮胎附着随滑移率变化」做成可离线校验的曲线与 ABS 目标带 #1246/feat(ground): 新增 rollover_margin,把「侧翻裕度」做成可离线校验的载荷转移与极限车速核算 #1249/feat(ground): 新增 ride_comfort_transmissibility,把「乘坐舒适性」做成可离线校验的传递率曲线与等级判定 #1252/feat(ground): 新增 lateral_stability_margin,把「不足转向」做成可离线校验的稳态转向角与稳定裕度核算 #1254 原本没有把自己的页面写进导航。
.github/workflows/ground_module_tests.yml:五个tests/test_*_local.py此前没有任何 workflow 会执行(
air_bridge_tests.yml跑固定文件名,ground_planner_tests.yml只覆盖带ci/run_ci.sh的两个模块),现在按 matrix 逐个跑。
本地验证
五个离线自检全部通过(Python 3.12 / numpy):
合入后 #1246~#1254 会自动显示为 merged。