xg_area_center — 2D xldgeom op

• Data kinds: contour → feature

• Call: fullseye.apply(img, "xg_area_center", a=0.5, b=0.5) (2-D model = एक image + दो scalar knobs a,b∈[0,1])

• HALCON समकक्ष: area_center_points_xld (अर्थ और parameters समझने के लिए HALCON reference उपयोगी है)

xg_area_center: input → output

*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 के रूप में दिखाए जाते हैं।*

*Knob a output नहीं बदलता (मापा गया: 0.1 / 0.5 / 0.9 पर एक जैसा)।*

*Knob b output नहीं बदलता (मापा गया: 0.1 / 0.5 / 0.9 पर एक जैसा)।*

Stages (पहले आने वाले ops → यह op, बाएँ से क्रम में):

▸ xg_area_center: stages का figure (docs site)

उपयोग

Shoelace formula से contour(s) का polygon क्षेत्रफल (abs का योग)।

contour dict {"shape": (H, W), "cs": [Nx2 (row, col) point arrays, ...]} के हर contour को polygon मानकर, shoelace formula 0.5*|Σ(x_i*y_{i+1} - x_{i+1}*y_i)| से क्षेत्रफल निकालता है और सभी contours का योग लौटाता है। 3 से कम points वाले contour को 0 मानकर अनदेखा किया जाता है। a, b उपयोग नहीं होते।

return value numpy.float64 है (इकाई pixel², normalise नहीं)। contour न हो, input dict न हो, या contour में non-finite मान हों, तो उन्हें छोड़ दिया जाता है और वे योग में नहीं जुड़ते (खाली हो तो 0.0)। ध्यान दें कि open contour के लिए भी "अंतिम point को पहले point से जोड़कर बंद किए गए polygon" का क्षेत्रफल मिलता है (सीधी रेखा वाले open contour में 0, पर polyline वाले open contour में भी शून्य से भिन्न)। निरपेक्ष मान लिया जाता है, इसलिए point sequence की दिशा (clockwise/counter-clockwise) परिणाम पर असर नहीं डालती। self-intersecting contour में crossings पर चिह्न एक-दूसरे को काट देते हैं, और परिणाम वास्तविक क्षेत्रफल से छोटा आता है। नाम के विपरीत यह centroid नहीं लौटाता (केवल क्षेत्रफल)। उसी point set के 2nd-order moments के लिए xg_moments, bbox के aspect ratio के लिए xg_height_width_ratio।

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

• gallery2d_geometry 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 में दिए गए हैं।

Studio में आज़माएँ

नीचे का program सच में चलता है, यह जाँचा गया है (figure वाला ही input)। Studio की help में यह block buttons बन जाता है, जिनसे इसे वहीं load करके चलाया जा सकता है।

threshold 0.50 0.50
sk_find_contours 0.50 0.50
xg_area_center 0.50 0.50

▸ यह pipeline load करें  ·  Load करके चलाएँ

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

• gallery2d_geometry — py -3.11 examples/gallery2d_geometry.py

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

identity · feature_to_img

इसी category के (xldgeom)

xg_moments · xg_eccentricity · xg_orientation · xg_elliptic_axis · xg_height_width_ratio · xg_regress_contours · xg_clip_contours · xg_gen_polygons


*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.