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 까지 가속(교통교칙(Kyosoku) 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.

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

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL 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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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