contact_patch_radius — DRIVE tacdome op

• 資料種類:image2d × scalar → table

• 呼叫: import fullseye as fs; fs.ledger.contact_patch_radius(img, pitch: 'float', ring_px: 'float' = 4.0) -> 'dict'(要直接呼叫實作,import tacdome; tacdome.contact_patch_radius(img, pitch: 'float', ring_px: 'float' = 4.0) -> 'dict';從台帳取用則 opsdrive.get("contact_patch_radius"))

用法

從接觸影像(dome_contact_image 的型別)讀取接觸半徑。以覆蓋率的線性和(面積法)利用到邊緣的次像素。

1) 以門檻 (1 % 點 + 99.9 % 點)/2 得到粗略的圓盤 → 重心與半徑 r_t。2) 以內側 r < r_t − ring_px 的中位數為 fg,外環

r_t + ring_px 〜 r_t + 2·ring_px 的中位數為 bg。3) 將覆蓋率 (I − bg)/(fg − bg) 在 r < r_t + ring_px 範圍內不截斷地加總(截斷會使雜訊偏向一側)→ a = pitch·√(Σ/π),重心以覆蓋率加權。回傳: a、a_px、a_threshold(門檻像素數的圓)、centre(列, 行)、fg、bg、edge_points(門檻圓盤的邊界像素 (列, 行),可傳給 measure.fit_circle)。Raises ValueError: 非 2 維、沒有明亮的圓盤(對比 0)、圓盤太小(r_t < 3 px)或碰到視窗邊緣。

參考(範例資料、文獻)

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

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

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

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

• poc_tacdome_large_deformation — py -3.11 examples/poc_tacdome_large_deformation.py

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

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

同類別(tacdome)

powerlaw_linear_contact · largedef_correction · largedef_radius_ratio · largedef_universal_correction · large_deformation_contact · large_deformation_inverse · mdr_spring_bed · neohookean_cylinder_exact

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

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