cooc_feature_matrix — 2D texture op

資料種類:imagefeature

呼叫:fullseye.apply(img, "cooc_feature_matrix", a=0.5, b=0.5)(2-D 的模型是一張圖 + 兩個純量旋鈕 a,b∈[0,1])

HALCON 對應:cooc_feature_matrix(其含義與參數可參考 HALCON 手冊)

cooc_feature_matrix: input → output

*圖為在 128×128 合成輸入上實際執行的輸出。左為輸入,右為輸出。點雲以俯視散點顯示(亮度 = z),一維序列為折線,體資料為沿 z 的最大值投影,影片為中間影格,複數影像為振幅;無法成像的回傳值直接顯示數值。*

掃描旋鈕 a(0.1 / 0.5 / 0.9,另一旋鈕取預設):

cooc_feature_matrix: knob a sweep (docs site)

掃描旋鈕 b(0.1 / 0.5 / 0.9,另一旋鈕取預設):

cooc_feature_matrix: knob b sweep (docs site)

用法

從灰階共生矩陣(GLCM,`skimage.feature.graycomatrix,量化為 16 階,距離 1+3*a,角度 0°)計算 Haralick 紋理特徵 energy(角二次矩,即矩陣值的集中程度=紋理均勻性)。相當於 HALCON 的 cooc_feature_matrix`(Calculate gray value features from a co-occurrence matrix.)(HALCON 可同時回傳多個特徵、多個角度,但這裡簡化為固定 energy、角度 0°)。

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

`a が共起を取る画素間距離を 1〜4 の範囲で振る。★b >= 0.75 で **0/45/90/135 度の 4 方向を平均**する(既定 b=0.5` は従来どおり 0 度だけなので、既存の結果は 1 ビットも変わらない)。

実写テクスチャ(brick / grass / gravel)を回して測ると(`poc_real_texture_invariance の節 6)、**効くかどうかは距離 a` で変わる**:

• まず `a` を伸ばすと素材どうしの分解能そのものが潰れる(0.0328 -> 0.0122、2.7 分の 1)。異方な brick の振れ幅は分解能の 0.30 -> 3.13 倍へ膨らむ。

• 4 方向平均は等方な素材には短中距離で効く(grass 0.23 -> 0.12、gravel 0.20 -> 0.11)。

• 異方な brick には距離 4 でだけ効き(3.13 -> 1.54)、距離 1 では逆に悪化する(0.30 -> 0.56)。

• 距離 4 まで来ると等方な grass すら改善しない(0.17 -> 0.19)—— 分解能が潰れたあとは平均しても取り返せない。

長い距離で使うときは、平均を掛ける前に素材がまだ分かれているかを確かめること。なお「取り違えの回数」で測ると手順(補間の次数・切り出し方・角度の刻み)に敏感で、比(振れ幅 / 分解能)のほうが安定する。

詳細使用指南

gallery2d_texture_freq 族使用指南

參考(範例資料・文獻)

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

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

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

在 Studio 中試試

下面的程式已確認可以執行(與圖相同的輸入)。在 Studio 說明中,此區塊會變成按鈕,可當場載入並執行。

cooc_feature_matrix 0.50 0.50

▸ Load this pipeline  ·  Load & run

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

gallery2d_texture_freqpy -3.11 examples/gallery2d_texture_freq.py

poc_real_texture_invariancepy -3.11 examples/poc_real_texture_invariance.py

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

identity · feature_to_img

同類別(texture)

std_filter · local_bimodality · local_std · scale_select_std · bootstrap_std_error · structure_tensor_orientation · structure_tensor_coherence · gabor


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

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