doppler_track — DRIVE decide op

• 資料種類:signal → table

• 呼叫: import fullseye as fs; fs.ledger.doppler_track(signal, fs, *, f_high: 'float' = 960.0, f_low: 'float' = 770.0, c: 'float' = 343.0, smooth: 'float' = 0.005, guard: 'float' = 0.01, edge: 'float' = 0.05, v_tol: 'float' = 1.0, verdict_window: 'float' = 0.5) -> 'Dict[str, object]'(要直接呼叫實作,import drivedecide; drivedecide.doppler_track(signal, fs, *, f_high: 'float' = 960.0, f_low: 'float' = 770.0, c: 'float' = 343.0, smooth: 'float' = 0.005, guard: 'float' = 0.01, edge: 'float' = 0.05, v_tol: 'float' = 1.0, verdict_window: 'float' = 0.5) -> 'Dict[str, object]';從台帳取用則 opsdrive.get("doppler_track"))

用法

從警笛聲估計瞬時頻率,判斷其正在接近還是遠離。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

1. 解析信号(FFT の Hilbert 変換)の位相差 → 瞬時周波数 f(t) = arg(z[n+1] z̄[n]) fs / 2π。

2. 幅 smooth 秒の移動中央値。

3. 各時刻で公称の 2 音(f_high / f_low)のうち比が近い方を「発した音」とみなし、ドップラー係数 D = f / f_nom、視線速度 v_r = c (1 − 1/D)(doppler_shift を v_r について解いたもの)。

4. 音が切り替わる所(中央値の跳び > 20 Hz)の前後 guard 秒と、両端 edge 秒は無効(valid = False)。

5. 判定: 最後の verdict_window 秒の有効な v_r の中央値が +v_tol より大 → "approaching"、−v_tol より小 → "receding"、間 → "abeam"。state は各時刻の同じ判定(無効な所は "unknown")。

公称音の取り違えの限界: 振り分けの境目は幾何平均 √(f_h f_l)。低い音が近づいて境目を越えるのは v_r = c (1 − √(f_l/f_h))、高い音が遠ざかって越えるのは v_r = −c (√(f_h/f_l) − 1)。960/770 Hz では +35.8 m/s(129 km/h)と −40.0 m/s。これより速い視線速度は取り違える(テストで固定)。

參考(範例資料、文獻)

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

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

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

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

• poc_driving_decisions — py -3.11 examples/poc_driving_decisions.py

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

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

同類別(decide)

mirror_reflection_matrix · mirror_virtual_camera · mirror_aim_normal · convex_mirror_fov · mirror_blind_zone · check_sequence_score · signal_phase_plan · signal_state


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

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