two_view_volume — DRIVE scoop op

• 資料種類:image2d × image2d × scalar → table

• 呼叫: import fullseye as fs; fs.ledger.two_view_volume(side_a, side_b, pitch: 'float', *, threshold: 'float' = 0.5) -> 'dict'(要直接呼叫實作,import scoop; scoop.two_view_volume(side_a, side_b, pitch: 'float', *, threshold: 'float' = 0.5) -> 'dict';從台帳取用則 opsdrive.get("two_view_volume"))

用法

由 2 個正交方向的側視影像求體積 —— 以每列的 2 條弦 W_a、W_b 為軸的橢圓之和 V = Σ f π (W_a/2)(W_b/2) pitch³。

截面為橢圓(非軸對稱的山、縱長的堆)時嚴格成立;僅用單側視圖的旋轉體假設會依橢圓扁平度之比偏離(PoC 中

1.6 : 1 的橢圓錐僅用單側時為 −38 % / +60 %)。以列的填充度 f(平面在列中途穿過的列,於像 a 中讀取)把弦

修正為 W = w / f 後再相乘(因為寬度之積會以 f² 少算)。先去除雜訊。2 張圖須為相同的高度刻度(同一列為

同一高度)。回傳: V、V_a/V_b(僅單側的旋轉體,Pappus)、ellipticity(弦之比的中位數 max/min)。Raises ValueError: 列數不同/不是覆蓋率/為空。

參考(範例資料、文獻)

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

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

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

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

• poc_powder_scoop_pour — py -3.11 examples/poc_powder_scoop_pour.py

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

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

同類別(scoop)

spoon_bowl_volume · scoop_synth_side · revolution_volume_side · scoop_volume_read · scoop_count · scoop_image_limit · tilt_wedge_retained · tilt_pour_rate

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

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