radial_reach_filter — CODEMATCH change op

• Data kinds: image2d × image2d → table

• Call: import fullseye as fs; fs.ledger.radial_reach_filter(background, image, t_p=0.08, agree_thresh=0.625, max_reach=32, min_dirs=4, min_decided_fraction=0.01) -> 'dict' (implementation को सीधे call करना हो तो import codematch; codematch.radial_reach_filter(background, image, t_p=0.08, agree_thresh=0.625, max_reach=32, min_dirs=4, min_decided_fraction=0.01) -> 'dict', registry से लेना हो तो opscodematch.get("radial_reach_filter"))

उपयोग

Radial Reach Filter (RRF): background और वर्तमान image की तुलना 8 दिशाओं के reach चिह्नों से करता है।

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

背景 B の画素 p から方向 d_k へ 1, 2, … と進み、|B(p + r d_k) - B(p)| >= t_p になる最初の r を reach r_k(max_reach まで。画像の外に出たらその方向は無効)。符号 b_k = [B(p + r_k d_k) >= B(p)]、現在の画像でも同じ位置の組で b'_k = [I(p + r_k d_k) >= I(p)] を作り、一致した方向の数を RRC とする。有効な方向のうち一致した割合が agree_thresh 未満の画素を前景にする(8 方向が全部有効なら、既定 0.625 は「一致 5 未満」)。

現在の画像に狭義単調増加の明るさの変換を掛けても、結果は 1 ビットも変わらない。影(局所の掛け算)の内側も同じ理由で前景にならない。

fail-closed: 有効な方向が min_dirs 未満の画素は判定しない(decided が False、rrc が -1、前景にもしない)。判定できた画素が min_decided_fraction 未満なら ValueError(背景が平坦すぎて、変化を言えない)。

返り: foreground(bool)、decided(bool)、rrc(一致した方向の数、判定しない画素は -1)、valid_dirs、agree_fraction(判定しない画素は 1.0)、reach((8, H, W)、無効は 0)、decided_fraction、foreground_fraction、refusal_margin(判定できた割合 − min_decided_fraction)。

उपयोग की विस्तृत guide

• robust_code_matching family guide

संदर्भ (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 करते हैं)

• poc_code_matching_breakdown — py -3.11 examples/poc_code_matching_breakdown.py

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

—

इसी category के (change)

—


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

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