gradient_coherence — REPRCONV derivative op

• Data kinds: gradient → voxel

• Call: import fullseye as fs; fs.ledger.gradient_coherence(gradient, sigma=1.5, eps=1e-12) (implementation को सीधे call करना हो तो import reprconv; reprconv.gradient_coherence(gradient, sigma=1.5, eps=1e-12), registry से लेना हो तो opsreprconv.get("gradient_coherence"))

• GPU: नहीं (केवल CPU reference implementation)

उपयोग

3-D gradient → structure tensor की sheet-likeness (coherence) voxel, range [0, 1]।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

各 voxel で勾配の外積 g gᵀ をガウス sigma で平均した構造テンソル J を作り、固有値 μ1 ≥ μ2 ≥ μ3 ≥ 0 から (μ1 − μ2) / (μ1 + μ2 + μ3 + eps) を返す(Westin の線形異方性を構造テンソルに当てたもの。Bigün & Granlund 1987、Westin 2002)。近傍の勾配が 1 方向にそろう(層・板・界面)と 1 に近づき、向きがばらばら(等方的なざらつき・塊)だと 0 に近づく。勾配の大きさには依らない(比なので)。平らで勾配の無い所は分母が eps だけになり 0 を返す。

gradient 型を一級の入力として受けるので、勾配の出どころ(gradient3d / sobel3d / 外部の微分可能レンダラ)を問わない。

Args:

gradient: gradient3d の (gmag, gvec) か sobel3d の (gz, gy, gx)。

sigma: 構造テンソルを平均するガウスの標準偏差 [voxel]。> 0。

eps: 分母の下駄(勾配ゼロの所で 0 を返すため)。> 0。

Returns:

(D, H, W) float64、[0, 1]。

Raises:

ValueError: 形が違う / 非有限 / sigma <= 0 / eps <= 0。

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• type_connectivity_tour — py -3.11 examples/type_connectivity_tour.py

वे अगले ops जिनसे type जुड़ता है (voxel को input के रूप में लेते हैं)

correlation_score · voxel_to_hessian

इसी category के (derivative)

gradient_magnitude · voxel_to_hessian · hessian_determinant · hessian_vesselness


*Provenance: reprconv.py — REPRCONV operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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