Skip to content

ground: 合入 #1246/#1249/#1250/#1252/#1254 五个模块,并补齐导航与 CI 挂接 - #1277

Closed
xingwunian wants to merge 38 commits into
masterfrom
ground/merge-1246-1254
Closed

xingwunian wants to merge 38 commits into
masterfrom
ground/merge-1246-1254

Conversation

@xingwunian

Copy link
Copy Markdown
Contributor

这个 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 做的三件事

  1. 每个 merge commit 里,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.md
  2. 顺带修正 feat(ground): 新增 drive_cycle_energy,把「工况能耗与续航」做成可离线复算的能量分解 #1250 原本把「乘坐舒适性传递率」写进自己导航行的串行问题(该行属于 feat(ground): 新增 ride_comfort_transmissibility,把「乘坐舒适性」做成可离线校验的传递率曲线与等级判定 #1252 的模块),
    feat(ground): 新增 tire_slip_curve,把「轮胎附着随滑移率变化」做成可离线校验的曲线与 ABS 目标带 #1246/feat(ground): 新增 rollover_margin,把「侧翻裕度」做成可离线校验的载荷转移与极限车速核算 #1249/feat(ground): 新增 ride_comfort_transmissibility,把「乘坐舒适性」做成可离线校验的传递率曲线与等级判定 #1252/feat(ground): 新增 lateral_stability_margin,把「不足转向」做成可离线校验的稳态转向角与稳定裕度核算 #1254 原本没有把自己的页面写进导航。
  3. 新增 .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):

tire_slip_curve                 全部通过
rollover_margin                 全部通过
drive_cycle_energy              全部通过
ride_comfort_transmissibility   结论:PASSED
lateral_stability_margin        结论:PASSED

合入后 #1246~#1254 会自动显示为 merged。

Wist-sutton and others added 8 commits November 11, 2026 19:54
新增 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。
@Donk-666-lcx

Copy link
Copy Markdown
Contributor

我按 PR 描述把 5 个模块的离线自测全跑了一遍,并把文档里的关键数值逐项复算对照。结论先说:测试全绿、数值和文档一致;但发现 1 个公式错配、1 个合并冲突(已在当前 master 上复现)。

一、我实际跑过的

python tests/test_tire_slip_curve_local.py                 # 通过 161 项,失败 0
python tests/test_rollover_margin_local.py                 # 通过 165 项,失败 0
python tests/test_drive_cycle_energy_local.py              # 通过 152 项,失败 0
python tests/test_ride_comfort_transmissibility_local.py   # 通过 112 项,失败 0
python tests/test_lateral_stability_margin_local.py        # 通过 116 项,失败 0

共 706 项断言,Python 3.13.14 / numpy 2.5.4,不需要 ROS,全部通过。

核心数值复算与文档一致:SSF 1.4000、a_crit 13.734 m/s²、极限车速 73.07 km/h(文档 73.1)、K=0.003399 rad/(m/s²)、特征车速 101.46 km/h、轮胎锁死附着 0.2129(占峰值 23.66%)、ABS 带 [0.0960, 0.1440]、能耗恒等式 drive − brake = ke + roll + aero 残差 0.000 J。这几条我逐项对过,没问题。

二、需要处理的两个问题

1. ride_core.py 的峰值位置用了力传递率的公式(P1)

RideSpec.transmissibility() 实现的是基座激励的位移传递率:

T(r) = sqrt( (1 + (2ζr)²) / ((1 − r²)² + (2ζr)²) )

它的峰值位置是 r_p = sqrt((sqrt(1 + 8ζ²) − 1) / (4ζ²));
而 peak_ratio() / peak_value() 用的是 sqrt(1 − 2ζ²),那是力传递率(绝对加速度传递率)的峰位,两者不是同一条曲线。

我拿代码和闭式解、数值扫描三方对拍(fn_hz=1,扫 8 万点):

ζ 代码 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+ 次提交,段尾是所有人都在抢的位置,插在段尾迟早要冲突。

三、其余建议

  1. 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),或把断点动能显式计入。

  2. CI 建议加 workflow_dispatch(P3):ground_module_tests.yml 只有 push/pull_request 的 paths 过滤。如果这个 check 以后被设成必需检查,只改 docs 的 PR 会一直 pending(或被直接跳过变成 pass),两种情况都不好排查。

  3. 5 个模块都是 catkin + rospy + ROS 1 launch(package.xml 还是 format 2),而仓库是 ros2。如果是有意保持 ROS 1 兼容,建议在 README 里写明;否则建议统一到 ament/rclpy,不然合并后仓库里会多 5 个在 ROS 2 环境下起不来的包。

  4. rollover_margin/package.xml 的 maintainer 是个人 QQ 邮箱,别的模块是 maintainer@example.com,建议统一成一个真实可用的联系方式。

@xingwunian 第 1、2 条建议合并前处理(第 2 条是硬阻塞),其余可以后续跟进。需要我把冲突那块解掉、或者补一个连续性校验的改动,直接说。

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.

3 participants