8000
VirtualDriver で交差点直進ルートが設定されているにも関わらず、軌跡(Traj)予測が直進と左折を高速に交互誤判定し、その結果、本来減速しない交差点で減速する(ユーザー実走行報告 2026-07-16)。
期待挙動: ルートが直進で確定しているなら、ジャンクション内パス予測は直進コネクションに安定して張り付き、減速要求は発生しない。
再現条件未特定(発生は確認済み)。直進ルート設定の交差点シナリオで発生。
切り分けメモ:
connection_idx=0
feature:F2 feature:F3 policy:conflict policy:junction_priority vd-phase:Phase3e openx:Domain#Junction commit:ee9d825b
regression (behavioral batch) — 「減速しないはず」のmatcher(min_speed_above)で表現可能
調査の結果、本 Issue の症状(直進ルートなのに直進Traj/左折Trajが高速交互→不要減速)の**真の原因は VirtualDriver ではなく、esmini の経路解決(RoadPath)**であることが判明しました。
RoadPath
AssignRouteAction
RoadPath::Calculate(dist, false)
GetConnectingLaneId≠0
GT_esmini/src/road/GT_RoadManager.cpp
CheckRoad
Calculate
AddWaypoint
minimal_waypoints_
"Route::AddWaypoint Skip waypoint for scenario routes since path not found"
on_route_ = false
TrajectoryShortPlanner
ConflictPointResolver::PredictPath
ManeuverAwareSpeedPlanner
RouteSignalScan
MoveAlongS(ds)
junctionSelectorAngle = -1.0
Position::MoveToConnectingRoad
else // randomize
予測 walker と同一 idiom(Duplicate + CopyRoute + MoveAlongS)を fabriksgatan / 4way / 斜め2車線 / LHT で掃引した結果、on-route の routed ego は常に決定的(randomize しない)、off-route フレームでのみ randomize。斜め・曲線コネクタ・2車線左レーン・LHT・ステアリング誤差(横±1.6m / ヘディング±0.15rad, 756サンプル)を入れても on-route では deviating=0。→ ジオメトリは trigger ではなく、「ルート未解決による off-route」が trigger。
Duplicate
CopyRoute
MoveAlongS
右折コネクタ上に waypoint を置き、road 単位で隣接する waypoint を設置すると、各ホップが1ホップで解決して経路が完全化 → ego が on-route を維持 → 症状消滅。
refs #31
junctionSelectorAngle = 0.0
RouteCrosswalkScan
ConflictPointResolver::FindUpcomingConnectingRoad
関連ID: feature:F2 policy:conflict commit:ee9d825b(Task B route-exhaustion 系譜) commit:e01ed4f2
feature:F2
policy:conflict
commit:ee9d825b
commit:e01ed4f2
fix(vd): deterministic junction path prediction for off-route walks (…
調査の結果、真因は RoadPath の経路探索欠陥ではなく、シナリオ側の Route Waypoint 記述の欠落だった。
恒久ルール(GT_esmini/docs/virtualdriver/design/scenario_authoring_foundation.md §10 に明文化): ルートが junction を跨ぐとき、元Arm → ConnectingRoad → 行先Arm の連続する各 Road に Waypoint を置く必要がある。ConnectingRoad を飛ばして行先 Arm に直接 Waypoint を置くと、RoadManager::Route::AddWaypoint のパス解決が Route::AddWaypoint Skip waypoint for scenario routes since path not found(WARN のみ、呼び出し側への伝播なし)で静かに失敗し、ルートが truncate される。以降 ego は off-route になり、junction 内パス予測が位置ベース推定に落ちて振動する。
GT_esmini/docs/virtualdriver/design/scenario_authoring_foundation.md
元Arm → ConnectingRoad → 行先Arm
RoadManager::Route::AddWaypoint
Route::AddWaypoint Skip waypoint for scenario routes since path not found
確認済みの実例: resources/xosc/verification/05_anticipation/decelerate_for_right_turn.xosc — WP は road3(lane -1, s=11) と road2(lane 1, s=200) の2本のみで、fabriksgatan_traffic_lights.xodr junction 4 の connecting road 13(predecessor=road3, successor=road2, lane -1→1)を素通りしていた。同じ road ペア (3,2) には逆方向専用の connecting road 16(lane -1→1 だが predecessor=road2/successor=road3)も存在し、road id ペアだけで連想すると誤った connecting road を選んでしまう — lane id を含めた exact match が必要な理由。
resources/xosc/verification/05_anticipation/decelerate_for_right_turn.xosc
fabriksgatan_traffic_lights.xodr
predecessor=road3
successor=road2
capability_model.md
function_catalog_vd_ad.yaml
resources/xosc/**
scripts/check_route_waypoints.py
resources/scenario_authoring/scenario_templates/generated/
authoring_common.make_route(..., xodr_path=...)
resources/scenario_authoring/validate_catalog.py
scenario_authoring_foundation.md
p6_virtual_junction/
RoadManager::Route::AddWaypoint がパス解決失敗を WARN ログ1行のみで静かにフォールバックし、呼び出し側が検知できない構造そのもの(今回の真因特定が長期化した根本原因)は、本 Issue のスコープ(シナリオ記述側の恒久ルール明文化・棚卸し修正)の外なので、#42 として切り出した。
run_regression_gate.ps1
関連ID: feature:F2 feature:F3 policy:conflict policy:junction_priority vd-phase:Phase3e openx:Domain#Junction
Closing — 恒久ルール明文化・既存資産の全数修正・再発防止(validate_catalog 組み込み)が完了。
ゲート確認完了: 回帰ゲート REGRESSION GATE: PASS (behavioral 27/27)。commit 27c7eec でクローズ。
fix(scenario-authoring): junction越えRoute WaypointのConnectingRoad欠落を是正 (…
feat(vd): vd-func:FUNC-050 目標レーン帯の算出とルート解決失敗の可視化 (RouteLanePlan)
Activity
GT-karny commentedon Jul 17, 2026
真因(root cause)の追記 — 症状は VD ではなく esmini の経路解決(RoadPath)にある
調査の結果、本 Issue の症状(直進ルートなのに直進Traj/左折Trajが高速交互→不要減速)の**真の原因は VirtualDriver ではなく、esmini の経路解決(
RoadPath)**であることが判明しました。症状の連鎖
AssignRouteActionの waypoint が交差点(特に右折レーンを間に挟む構成)を跨ぐと、RoadPath::Calculate(dist, false)が接続を見つけられない。この探索は ①前方一方向のみ(bothDirections=false)②各ホップでGetConnectingLaneId≠0(レーン単位接続)を要求する Dijkstra(GT_esmini/src/road/GT_RoadManager.cpp—CheckRoad:6261 /Calculate:6415 /AddWaypoint:15341)。minimal_waypoints_に追加されず skip され、警告"Route::AddWaypoint Skip waypoint for scenario routes since path not found"(同 15326)が出る → ルートが交差点手前で truncate(不完全化)。on_route_ = false)。TrajectoryShortPlannerの preview=「Traj」本体,ConflictPointResolver::PredictPath,ManeuverAwareSpeedPlanner,RouteSignalScan等)はMoveAlongS(ds)便利版(junctionSelectorAngle = -1.0)で歩くため、off-route フレームでPosition::MoveToConnectingRoadのelse // randomize分岐に落ち、接続路を毎フレームランダム選択 → 直進コネクタ/左折コネクタが交互=「直進Traj/左折Traj交互」→ 交差点減速系ポリシーが誤反応。実証
予測 walker と同一 idiom(
Duplicate+CopyRoute+MoveAlongS)を fabriksgatan / 4way / 斜め2車線 / LHT で掃引した結果、on-route の routed ego は常に決定的(randomize しない)、off-route フレームでのみ randomize。斜め・曲線コネクタ・2車線左レーン・LHT・ステアリング誤差(横±1.6m / ヘディング±0.15rad, 756サンプル)を入れても on-route では deviating=0。→ ジオメトリは trigger ではなく、「ルート未解決による off-route」が trigger。回避策(確認済)
右折コネクタ上に waypoint を置き、road 単位で隣接する waypoint を設置すると、各ホップが1ホップで解決して経路が完全化 → ego が on-route を維持 → 症状消滅。
対応状況
refs #31): 予測 walker 6箇所をjunctionSelectorAngle = 0.0(決定的な最直進)に変更。ルートが不完全でも VD が flicker しない堅牢化。全259ユニット緑・回帰ゲート deviations=0。ただしこれは症状対策であり root ではない。既修正の兄弟RouteCrosswalkScan/ConflictPointResolver::FindUpcomingConnectingRoadと方針を揃えたもの。RoadPathの経路探索が右折レーン経由の非隣接 waypoint を自動解決できない点。修正候補:RoadPath強化(bothDirections 探索 / レーン→道路レベルのフォールバック)。核ルーティング改修のため回帰リスク高・upstream 乖離 → upstream-candidate として検討。関連ID:
feature:F2policy:conflictcommit:ee9d825b(Task B route-exhaustion 系譜)commit:e01ed4f2fix(vd): deterministic junction path prediction for off-route walks (…
GT-karny commentedon Aug 2, 2026
真因確定(起票時仮説の訂正)
調査の結果、真因は RoadPath の経路探索欠陥ではなく、シナリオ側の Route Waypoint 記述の欠落だった。
恒久ルール(
GT_esmini/docs/virtualdriver/design/scenario_authoring_foundation.md§10 に明文化): ルートが junction を跨ぐとき、元Arm → ConnectingRoad → 行先Armの連続する各 Road に Waypoint を置く必要がある。ConnectingRoad を飛ばして行先 Arm に直接 Waypoint を置くと、RoadManager::Route::AddWaypointのパス解決がRoute::AddWaypoint Skip waypoint for scenario routes since path not found(WARN のみ、呼び出し側への伝播なし)で静かに失敗し、ルートが truncate される。以降 ego は off-route になり、junction 内パス予測が位置ベース推定に落ちて振動する。確認済みの実例:
resources/xosc/verification/05_anticipation/decelerate_for_right_turn.xosc— WP は road3(lane -1, s=11) と road2(lane 1, s=200) の2本のみで、fabriksgatan_traffic_lights.xodrjunction 4 の connecting road 13(predecessor=road3,successor=road2, lane -1→1)を素通りしていた。同じ road ペア (3,2) には逆方向専用の connecting road 16(lane -1→1 だが predecessor=road2/successor=road3)も存在し、road id ペアだけで連想すると誤った connecting road を選んでしまう — lane id を含めた exact match が必要な理由。訂正: 起票時・調査中に立てた仮説はいずれも誤り
connection_idx=0(XODR記載順先頭)無条件採用の系譜」— 不成立。実際は Route 自体が junction 手前で truncate されており、junction 内コネクション選択ロジック(connection_idx)に到達する前の問題だった。capability_model.mdFUNC-049 に記載されていた「issue VirtualDriver: 交差点直進ルート設定時にTraj予測が直進/左折を高速交互誤判定し不要な減速が発生 #31 で右折レーン接続失敗」— 誤り。RoadPath 自体は正しく動作しており、シナリオ記述側の Waypoint 欠落が原因。該当 note は訂正済み(function_catalog_vd_ad.yamlFUNC-049 も同様)。対応
resources/xosc/**を全数棚卸しし、同型の Waypoint 欠落を機械検出(scripts/check_route_waypoints.py、junction connecting road を lane 単位で directional に照合)。16 ファイル・17 箇所で発見、全件を Waypoint 追加のみで修正(ルートの意図は変更なし)。resources/scenario_authoring/scenario_templates/generated/の生成カタログ(Phase 3d/3e 用、gen_07/gen_08)にも同型の欠落を発見(36ファイル中複数)。生成器authoring_common.make_route(..., xodr_path=...)に自動補完ロジックを追加し、カタログを再生成して修正。resources/scenario_authoring/validate_catalog.pyの静的チェックに (e) として組み込み、生成カタログでの再発を機械的に防止。scenario_authoring_foundation.md§10 に明文化。virtual junction(p6_virtual_junction/)は異なるルーティング機構(アンカー方式)を意図的に検証しているため対象外と明記。残課題(別 Issue に切り出し)
RoadManager::Route::AddWaypointがパス解決失敗を WARN ログ1行のみで静かにフォールバックし、呼び出し側が検知できない構造そのもの(今回の真因特定が長期化した根本原因)は、本 Issue のスコープ(シナリオ記述側の恒久ルール明文化・棚卸し修正)の外なので、#42 として切り出した。ゲート確認
scripts/check_route_waypoints.py— resources/xosc/ 全169ファイル、FAIL 0件(p6_virtual_junction の2件は仕様上の除外として info 表示)resources/scenario_authoring/validate_catalog.py(実行チェック込み)— 56/56 PASSrun_regression_gate.ps1)— 確認中関連ID: feature:F2 feature:F3 policy:conflict policy:junction_priority vd-phase:Phase3e openx:Domain#Junction
Closing — 恒久ルール明文化・既存資産の全数修正・再発防止(validate_catalog 組み込み)が完了。
GT-karny commentedon Aug 2, 2026
ゲート確認完了: 回帰ゲート REGRESSION GATE: PASS (behavioral 27/27)。commit 27c7eec でクローズ。
fix(scenario-authoring): junction越えRoute WaypointのConnectingRoad欠落を是正 (…
feat(vd): vd-func:FUNC-050 目標レーン帯の算出とルート解決失敗の可視化 (RouteLanePlan)