region op• Data kinds: region → image
• Call: fullseye.apply(img, "dist_transform_abs", a=0.5, b=0.5) (2-D model = एक image + दो scalar knobs a,b∈[0,1])
• HALCON समकक्ष: distance_transform (अर्थ और parameters समझने के लिए HALCON reference उपयोगी है)
• GPU: नहीं (केवल CPU reference implementation)
*Figure synthetic 128×128 input पर सच में चलाकर मिला output है। बाईं ओर input, दाईं ओर output। Point clouds ऊपर से देखे गए scatter के रूप में (brightness = z), 1-D series line के रूप में, volumes z दिशा में maximum-intensity projection के रूप में, videos बीच के frame के रूप में, complex images amplitude के रूप में, और जो return values चित्र नहीं बन सकते वे स्वयं values के रूप में दिखाए जाते हैं।*
*Output viridis जैसे pseudo-colour में है (गहरा बैंगनी = कम, पीला = अधिक), ताकि distance, phase, orientation, depth जैसे "मात्राओं के field" पढ़े जा सकें।*
Knob a को बदलकर (0.1 / 0.5 / 0.9, दूसरा knob default पर):
▸ dist_transform_abs: knob a को बदलने का figure (docs site)
Knob b को बदलकर (0.1 / 0.5 / 0.9, दूसरा knob default पर):
▸ dist_transform_abs: knob b को बदलने का figure (docs site)
Stages (पहले आने वाले ops → यह op, बाएँ से क्रम में):
▸ dist_transform_abs: stages का figure (docs site)
दूसरी images पर भी (synthetic scene / photo / coins। ऊपर की row में inputs, नीचे की row में उनके outputs। Knobs default पर):
▸ dist_transform_abs: दूसरी images पर output (docs site)
बिना सामान्यीकरण के निरपेक्ष pixel दूरी का distance transform। HALCON के distance_transform (Compute the distance transformation of a region.) के समकक्ष है।
a दूरी का प्रकार चुनता है: a < 1/3 Euclidean, 1/3 <= a < 2/3 city-block (L1), अन्यथा chessboard (L∞)। b < 0.5 हर foreground pixel के लिए निकटतम background pixel तक की दूरी देता है; b >= 0.5 हर background pixel के लिए निकटतम foreground pixel तक की दूरी देता है। output float64 image है और dist_transform के विपरीत image के अधिकतम से सामान्यीकृत नहीं होता (background से घिरे 3×3 और 9×9 वर्ग के केंद्र क्रमशः 2 और 5 हैं)। उदाहरण: _dist_transform_abs(np.pad(np.ones((3, 3)), 1), 0, 0)[2, 2] का मान 2.0 है।
★2026-11-05 (adversarial verification, दौर 2, P4b) तक यह उदाहरण np.ones((3, 3)) (background नहीं) लिखा था, और वास्तविक मान 2.0 नहीं बल्कि 2.236 था (नीचे वाला degenerate input)।
जब जिस लक्ष्य तक दूरी मापनी है वह छवि में नहीं है (b < 0.5 में एक भी पृष्ठभूमि पिक्सेल नहीं, b >= 0.5 में कोई अग्रभूमि नहीं), तब दूरी परिभाषित नहीं है (अनंत)। उस स्थिति में समान 0 ("कोई दूरी-क्षेत्र नहीं") लौटाया जाता है —— खाली region एक वैध इनपुट है (b >= 0.5 में पूरी पृष्ठभूमि भी और b < 0.5 में पूरा अग्रभूमि भी), इसलिए इसे अपवाद नहीं बनाया जाता। इस 0 को दूरी के रूप में न पढ़ें:
लक्ष्य मौजूद है या नहीं, यह इनपुट की ओर region.any() / (~region).any() से जाँचें। दोनों दिशाओं में परिणाम समान है, इसलिए यह छवि के पलटने और घुमाने के साथ क्रमविनिमेय है। 2026-11-05 (adversarial verification, round 2, P4) तक distance_transform_edt ऐसी ढलान (3×3 पर 1〜3.6) लौटाता था मानो लक्ष्य छवि के बाहर (-1, 0) पर हो, और cdt समान -1 लौटाता था।
HALCON का संदर्भ operator int4 सन्निकटन देता है। यह op सटीक float64 दूरी देता है और compatibility API नहीं है।
अपवाद:
FsValueError: image में NaN / inf है।
• gallery2d_region family guide
• 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 में दिए गए हैं।
नीचे का program सच में चलता है, यह जाँचा गया है (figure वाला ही input)। Studio की help में यह block buttons बन जाता है, जिनसे इसे वहीं load करके चलाया जा सकता है।
threshold 0.50 0.50 dist_transform_abs 0.50 0.50
▸ यह pipeline load करें · Load करके चलाएँ
• gallery2d_region — py -3.11 examples/gallery2d_region.py
image को input के रूप में लेते हैं)identity · gaussian · mean_box · mean_box_wh · bilateral · kuwahara · unsharp · median
region)reg_erode · reg_dilate · reg_open · reg_close · fill_holes · select_largest · remove_small · invert_region
*Provenance: ops.py — 2D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.