features op• 資料種類:region → match
• 呼叫:fullseye.apply(img, "eccentricity", a=0.5, b=0.5)(2-D 的模型是一張圖 + 兩個純量旋鈕 a,b∈[0,1])
• HALCON 對應:eccentricity(其含義與參數可參考 HALCON 手冊)
*圖為在 128×128 合成輸入上實際執行的輸出。左為輸入，右為輸出。點雲以俯視散點顯示(亮度 = z)，一維序列為折線，體資料為沿 z 的最大值投影，影片為中間影格，複數影像為振幅；無法成像的回傳值直接顯示數值。*
*旋鈕 a 不改變輸出(實測: 0.1 / 0.5 / 0.9 相同)。*
*旋鈕 b 不改變輸出(實測: 0.1 / 0.5 / 0.9 相同)。*
階段(前置運算子 → 本運算子，由左至右):
▸ eccentricity: 處理階段 (文件網站)
以 match 排序的 3 分量向量回傳三個由橢圓參數導出的形狀特徵 (Anisometry, Bulkiness, StructureFactor)(單一純量無法表示三個值,與 area_center 形式相同)。
設 Ra/Rb 為具有相同矩的橢圓的半徑,A 為面積:
Anisometry = Ra/Rb(細長程度。圓為 1,下限 1)
Bulkiness = π·Ra·Rb / A(橢圓有多少沒有被填滿。圓為 1)
StructureFactor = Anisometry·Bulkiness - 1(圓為 0)
與 HALCON 的 eccentricity（Shape features derived from the ellipse parameters.）是相同的 3 個值、相同的公式。3 個都是無因次量,因此未做正規化。
★2026-09-26 之前以 1 個純量回傳 skimage 的離心率 sqrt(1-(b/a)²),這是3 個中哪一個都不是的量(圓上 0.0 對 HALCON 的 1.0,4x80 的棒上 0.999 對 20.65)。由於 1 個純量無法表示 3 個值,已改為與 area_center 相同的 match sort。docs/hardening/halcon-named-shape-factors.md。
區域為空時按 fail-soft 規格回傳圓的值 (1, 1, 0)(分量數不隨輸入而變)。a、b 未使用。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• 演算法的正典(作者、年份)與用途見上面的族使用指南。
下面的程式已確認可以執行(與圖相同的輸入)。在 Studio 說明中，此區塊會變成按鈕，可當場載入並執行。
threshold 0.50 0.50 eccentricity 0.50 0.50
• gallery2d_features — py -3.11 examples/gallery2d_features.py
• poc_rotation_invariance_audit — py -3.11 examples/poc_rotation_invariance_audit.py
match 作為輸入)features)effective_bit_depth · blob_count · area_frac · count_contours · total_length · vol_count · sk_euler · sk_entropy_feat
*Provenance: ops.py — 2D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.