overtake_requirement — DRIVE pass op

• 資料種類:無 → table(僅由參數決定的運算子 —— 不接受影像或資料輸入)

• 呼叫: import fullseye as fs; fs.ledger.overtake_requirement(v_ego: 'float', v_lead: 'float', *, lead_length: 'float', ego_length: 'float', gap_back: 'float', gap_front: 'float', accel: 'float' = 0.0, v_max: 'Optional[float]' = None, lane_change_time: 'float' = 0.0, v_oncoming: 'float' = 0.0, pet_min: 'float' = 0.0) -> 'Dict[str, float]'(要直接呼叫實作,import drivepass; drivepass.overtake_requirement(v_ego: 'float', v_lead: 'float', *, lead_length: 'float', ego_length: 'float', gap_back: 'float', gap_front: 'float', accel: 'float' = 0.0, v_max: 'Optional[float]' = None, lane_change_time: 'float' = 0.0, v_oncoming: 'float' = 0.0, pet_min: 'float' = 0.0) -> 'Dict[str, float]';從台帳取用則 opsdrive.get("overtake_requirement"))

用法

超越前車所需的時間、距離,以及對向來車不會到來的臨界距離(閉合式)。場景 S079、S086、S145(第28條第4項)。

從本車前端在前車後端之前 gap_back 處駛入對向車道(或右側車道)起,到本車後端超出前車前端 gap_front 為止(相對距離 D = gap_back + lead_length + ego_length + gap_front)。本車從初速 v_ego 以 accel 加速到 v_max(《交通教則》5-6-3(4)「在最高速限內一邊加速」),前車以 v_lead 等速。之後用 lane_change_time 完全回到原車道。若在 gap_front 中填入 overtake_return_gap 的值,就成為「前進到被超車輛在車內後視鏡中可見的距離」再返回的步驟(教則 5-6-3(6))。

回傳值:relative_distance = D、t_pass、t_occupy = t_pass + lane_change_time、ego_distance(占用期間本車行駛的路程)、v_pass(超車完成時的速度)、d_required = ego_distance + v_oncoming (t_occupy + pet_min)(若判斷時對向車比這更遠,則對向車在本車完全返回後至少 pet_min 秒才到達該地點)。無法超到前方(相對速度不為正)會引發 ValueError。

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• poc_driving_pass — py -3.11 examples/poc_driving_pass.py

型別可銜接的下一個運算子(可接受 table 作為輸入)

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

同類別(pass)

overtake_return_gap · no_overtaking_zones · overtake_permitted · overtaken_conduct_check · lane_change_follower_decel · lane_change_permitted · roundabout_entry_check · roundabout_signal_point


*Provenance: drivepass.py — DRIVE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.