diff --git a/docs/gallery.md b/docs/gallery.md index ebf3bbb..d21446b 100644 --- a/docs/gallery.md +++ b/docs/gallery.md @@ -19,6 +19,9 @@ title: 效果展示 ![借道超车遇对向来车](img/scenario_overtake_oncoming.gif)
overtake_oncoming(借道超车遇对向来车)播放 8 秒:借对向车道超车 → 对向车接近 → 放弃超车回原车道(红圈为对向车,黄圈为慢车,11 帧;底部为口语输入与命中模板)
+![前车切出遇静止车辆](img/scenario_cut_out.gif) +
cut_out(前车切出遇静止车辆)播放 6 秒:前车让出本车道 → 露出静止车 → 自车制动停车(红圈为静止车,黄圈为前车,10 帧;底部为口语输入与命中模板)
+ ![运行指标](img/scenario_run_metrics.gif)
运行危险度指标:右上角实时显示自车速度、与行人距离与 TTC,末帧汇总碰撞/最小中心距/最小 TTC/最大减速度/末速
diff --git a/docs/img/scenario_cut_out.gif b/docs/img/scenario_cut_out.gif new file mode 100644 index 0000000..58af7d6 Binary files /dev/null and b/docs/img/scenario_cut_out.gif differ diff --git a/docs/new-features.md b/docs/new-features.md index b820ed7..21b19ff 100644 --- a/docs/new-features.md +++ b/docs/new-features.md @@ -8,6 +8,83 @@ title: New Features --- +## 2026-11 · 前车切出遇静止车辆场景 + +本版新增 `cut_out` 模板:前车变道让出本车道,露出正前方的静止车辆, +自车按相对距离制动停车。该场景对应 AEB 的 cut-out 测试。 + +### 1. 用法 + +```text +前车突然向左变道,露出前方停着的故障车 +前车切出后,本车道正前方有一辆静止车辆 +``` + +语义层把 `前车切出`、`切出`、`变道露出`、`露出前方`、`前方停着` +等说法路由到该模板;输入同时含"变道"与"露出"或"前方"与"停着"时额外加权, +避免落到只描述前车急刹的 `lead_brake`。 + +```python +plan_scenario("前车突然向左变道,露出前方停着的故障车") +# → {"template": "cut_out", "confidence": 1.0, ...} +``` + +### 2. 场景编排 + +自车 50 m 处起步、12 m/s,前方 28 m 处前车 9 m/s,再往前 36 m 停着一辆静止车辆。 +2.5 s 时前车向右变道让出本车道;自车与静止车中心距缩到 30 m 时线性制动到停车。 + +| 时刻 | 事件 | +|---|---| +| 0 s | 自车 12 m/s、前车 9 m/s、静止车 0 m/s 同时布景 | +| 2.5 s | 前车向右变道让出本车道,静止车进入视野 | +| 距静止车 30 m | 自车线性制动 | +| 约 5.9 s | 自车停在静止车前约 12 m,无碰撞 | + +参数:`s0`、`road_id`、`lane`、`ego_speed`、`lead_speed`、`lead_gap`、 +`stopped_gap`、`lc_delay`、`brake_gap`、`brake_time`,均可通过 `params_json` 覆盖。 + +### 3. 城市地图 + +模板默认按生成路网的 `roadId=1 / lane=-1 / s0=50` 布景。要在内置城市地图上运行, +用 `road_id`、`lane`、`s0` 指定一段同向至少两条车道、无路侧障碍的长直路: + +```text +run_scenario_in_carla(template="cut_out", map_name="Town10HD_Opt", + params_json='{"road_id": "12", "lane": "-1", "s0": 30}') +``` + +相对距离按两车中心点的直线距离计算,弯道会让距离缩减得比沿路里程慢, +所以城市路段应尽量平直;路段内的静态车辆与路侧停放物需要调用方自行避开。 + +### 4. 效果 + +![前车切出遇静止车辆](img/scenario_cut_out.gif) +
cut_out:前车切出让出本车道 → 露出静止车 → 自车制动停车(红圈为静止车,黄圈为前车,10 帧)
+ +### 5. 实测结果 + +| 项目 | 结果 | +|---|---| +| 离线回归(18 个模板) | 全部通过,3 实体 / 5 事件 | +| CARLA 实跑(`wide_straight`) | 5 个事件全部触发,2.55 s 前车切出,2.85 s 触发制动,无碰撞 | +| 最小 TTC | 2.36 s(t=3.60 s,静止车) | +| 最小中心距 | 11.64 m(t=5.85 s,静止车) | +| 制动减速度 | 约 4.0 m/s²(12 m/s 经 3 s 线性刹停) | +| 自车末速 | 0.04 m/s(已停止) | +| 语义识别 | `前车切出`、`露出前方停着的故障车` 均命中 `cut_out` | + +### 6. 已知限制 + +- 前车切出后继续以 9 m/s 行驶,会在片段后段驶过静止车辆旁侧, + 画面中两车短暂相邻,不代表冲突。 +- `lead_cut_out` 的变道方向 `-1` 针对 `wide_straight` 的车道编号, + 换用其他路网或城市地图时需确认目标车道存在。 +- 制动按 3 s 线性减速到 0,未接入真实 AEB 的分级触发逻辑。 +- 城市地图上路段由调用方指定,模板不做路侧静态物的避让检查。 + +--- + ## 2026-11 · 借道超车遇对向来车场景 本版新增 `overtake_oncoming` 模板:自车借对向车道超越前方慢车, diff --git a/docs/scenario.md b/docs/scenario.md index 03db459..0bc8fe1 100644 --- a/docs/scenario.md +++ b/docs/scenario.md @@ -34,7 +34,7 @@ graph LR |---|---|---|---| | `file_path` | string | 必填 | 待校验的 `.xosc` 文件 | -## 3. 17 个场景模板 +## 3. 18 个场景模板 | 模板 | 场景含义 | 实体数 | 主要触发 | |---|---|---|---| @@ -42,6 +42,7 @@ graph LR | `lead_stationary` | 前车静止 | 2 | 时间 | | `cut_in` | 危险切入 | 4 | 时间、时距、速度、到达 | | `cut_in_then_brake` | 加塞后急刹 | 3 | 时间(变道、急刹分阶段) | +| `cut_out` | 前车切出遇静止车辆(AEB cut-out) | 3 | 时间、相对距离 | | `crossing_hazard` | 行人/车辆横穿 | 2 | 时间、距离 | | `occluded_crossing` | 鬼探头(遮挡横穿) | 3 | 时间、距离 | | `low_overlap` | 前方低重叠率目标 | 3 | 时间、距离、速度、到达 | @@ -109,6 +110,54 @@ graph LR 与 `overtake` 的区别是多了对向车的存在与"放弃超车"的判定, `overtake` 只演示变道超越,不处理会车冲突。 +### 3.3 前车切出遇静止车辆 `cut_out` + +双向直路上,自车以 12 m/s 跟随前方 9 m/s 的前车;前车在本车道前方 28 m 处, +再往前 36 m 停着一辆静止车辆。2.5 s 时前车向右变道让出本车道,露出静止车辆; +自车在距静止车 30 m 时线性制动到停车,最终停在静止车前约 12 m,无碰撞。 + +该模板对应 AEB 的 cut-out 测试:目标并非突然出现,而是被前车遮挡, +前车让开后才发现本车道正前方有静止障碍。 + +```text +前车突然向左变道,露出前方停着的故障车 +前车切出后,本车道正前方有一辆静止车辆 +``` + +![前车切出遇静止车辆](img/scenario_cut_out.gif) +
cut_out:前车切出让出本车道 → 露出静止车 → 自车制动停车(红圈为静止车,黄圈为前车,10 帧)
+ +| 参数 | 默认 | 说明 | +|---|---|---| +| `s0` | 50 m | 自车在所选车道上的起点弧长 | +| `road_id` | `1` | 路段编号,城市地图上用于指定具体道路 | +| `lane` | `-1` | 自车车道号,前车向 `lane-1` 变道 | +| `ego_speed` | 12 m/s | 自车速度 | +| `lead_speed` | 9 m/s | 前车速度 | +| `lead_gap` | 28 m | 自车与前车的初始距离 | +| `stopped_gap` | 36 m | 静止车与前车的距离 | +| `lc_delay` | 2.5 s | 前车开始切出的时刻 | +| `lc_time` | 1.6 s | 变道持续时间 | +| `brake_gap` | 30 m | 自车开始制动的相对距离阈值 | +| `brake_time` | 3.0 s | 制动到停车的时间 | + +触发同样是**相对距离**:自车与 `stopped` 的中心距小于 `brake_gap` 时, +自车线性减速到 0。与 `cut_in` / `cut_in_then_brake` 的区别是冲突目标不是 +变道车辆本身,而是变道后暴露出来的静止障碍;与 `lead_stationary` 的区别是 +静止车辆初始被前车遮挡,自车直到前车切出后才需要响应。 + +**城市地图**:模板默认按生成路网的 `roadId=1 / lane=-1 / s0=50` 布景。 +在 `Town03`、`Town10HD_Opt` 等内置地图上运行时,用 `road_id`、`lane`、`s0` +指定一段**同向至少两条车道、无路侧障碍的长直路**: + +```text +run_scenario_in_carla(template="cut_out", map_name="Town10HD_Opt", + params_json='{"road_id": "12", "lane": "-1", "s0": 30}') +``` + +相对距离按两车中心点的直线距离计算,弯道会让"距离缩减"比沿路里程更慢, +因此城市路段应尽量平直;路段内的静态车辆、路侧停放物需要调用方自行避开。 + ## 4. 对话示例 ```text