passing_gap_required — DRIVE traffic op

• 데이터 종류: 없음 → table(인자만으로 정해지는 연산자 —— 이미지나 데이터 입력을 받지 않습니다)

• 호출: import fullseye as fs; fs.ledger.passing_gap_required(parked_len: 'float', margin_front: 'float', margin_back: 'float', v_ego: 'float', v_oncoming: 'float', *, lane_change_time: 'float', ego_length: 'float' = 0.0, pet_min: 'float' = 0.0, v_obstacle: 'float' = 0.0) -> 'Dict[str, float]'(구현을 직접 호출하려면 import drivetraffic; drivetraffic.passing_gap_required(parked_len: 'float', margin_front: 'float', margin_back: 'float', v_ego: 'float', v_oncoming: 'float', *, lane_change_time: 'float', ego_length: 'float' = 0.0, pet_min: 'float' = 0.0, v_obstacle: 'float' = 0.0) -> 'Dict[str, float]', 원장에서 가져오려면 opsdrive.get("passing_gap_required"))

사용법

> 이 연산자의 설명은 아직 번역이 없습니다. 원문을 그대로 싣습니다.

駐車車両を避けて対向車線にはみ出す区間を抜ける時間と、対向車がそれまでに来ない境目の距離(閉形式)。

自車は駐車車両の後端の `margin_back 手前(x_in)で対向車線に出始め、前端の margin_front` 先(x_out)を

過ぎてから `lane_change_time` かけて自車線へ戻り切る。はみ出す長さ L_occ = margin_back + parked_len +

margin_front + ego_length、はみ出している時間 t_occ = L_occ / v_ego + T_lc。戻り切った地点

P = x_in + L_occ + v_ego T_lc に対向車が着くのが戻り切った時刻より `pet_min` 以上後(PET ≥ pet_min)である

ための、判断時(自車が x_in)の対向車までの距離の境目:

D* = t_occ (v_ego + v_on) + v_on · pet_min

走っている障害物(自転車など、同じ向きに `v_obstacle` で進む): はみ出す長さは障害物に対する相対の距離なので

t_occ = L_occ / (v_ego − v_obstacle) + T_lc、戻り切った地点 P = x_in + v_ego t_occ。D* の式は同じ形。

v_obstacle = 0 で止まっている車の式に戻る。

戻り値 dict: `L_occ, t_occupy, d_required (= D*)、clear_point`(x_in から P までの距離)。

Raises `ValueError`: 負の長さ・余裕、v_ego ≤ 0、v_oncoming < 0、lane_change_time < 0、

v_obstacle < 0 か v_obstacle ≥ v_ego(追いつけない)。

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• poc_driving_traffic — py -3.11 examples/poc_driving_traffic.py

타입이 이어지는 다음 연산자(table 를 입력으로 받는 것)

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

같은 카테고리(traffic)

idm_accel · idm_equilibrium_gap · idm_platoon_simulate · driver_style · lateral_wobble · ou_estimate · social_force_step · pedestrian_crossing


*Provenance: drivetraffic.py — DRIVE 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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