Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions docs/gallery.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,9 @@ title: 效果展示
![借道超车遇对向来车](img/scenario_overtake_oncoming.gif)
<div align="center"><i>overtake_oncoming(借道超车遇对向来车)播放 8 秒:借对向车道超车 → 对向车接近 → 放弃超车回原车道(红圈为对向车,黄圈为慢车,11 帧;底部为口语输入与命中模板)</i></div>

![前车切出遇静止车辆](img/scenario_cut_out.gif)
<div align="center"><i>cut_out(前车切出遇静止车辆)播放 6 秒:前车让出本车道 → 露出静止车 → 自车制动停车(红圈为静止车,黄圈为前车,10 帧;底部为口语输入与命中模板)</i></div>

![运行指标](img/scenario_run_metrics.gif)
<div align="center"><i>运行危险度指标:右上角实时显示自车速度、与行人距离与 TTC,末帧汇总碰撞/最小中心距/最小 TTC/最大减速度/末速</i></div>

Expand Down
Binary file added docs/img/scenario_cut_out.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
77 changes: 77 additions & 0 deletions docs/new-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
<div align="center"><i>cut_out:前车切出让出本车道 → 露出静止车 → 自车制动停车(红圈为静止车,黄圈为前车,10 帧)</i></div>

### 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` 模板:自车借对向车道超越前方慢车,
Expand Down
51 changes: 50 additions & 1 deletion docs/scenario.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,14 +34,15 @@ graph LR
|---|---|---|---|
| `file_path` | string | 必填 | 待校验的 `.xosc` 文件 |

## 3. 17 个场景模板
## 3. 18 个场景模板

| 模板 | 场景含义 | 实体数 | 主要触发 |
|---|---|---|---|
| `lead_brake` | 前车急刹 | 3 | 时间 |
| `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 | 时间、距离、速度、到达 |
Expand Down Expand Up @@ -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)
<div align="center"><i>cut_out:前车切出让出本车道 → 露出静止车 → 自车制动停车(红圈为静止车,黄圈为前车,10 帧)</i></div>

| 参数 | 默认 | 说明 |
|---|---|---|
| `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
Expand Down
Loading