aabb — 3D bounds op

• Data kinds: points → primitive

• Call: import fullseye as fs; fs.ledger.aabb(points) (implementation को सीधे call करना हो तो import pcseg; pcseg.aabb(points), registry से लेना हो तो ops3d.get("aabb"))

उपयोग

axis-aligned bounding box। (min (3,), max (3,)) लौटाता है।

point cloud के हर axis का न्यूनतम और अधिकतम मान जैसा है वैसा लौटाता है (P.min(0), P.max(0))। return value 2 (3,) float64 arrays हैं, क्रम से (xmin, ymin, zmin) और (xmax, ymax, zmax) (axes का क्रम input के columns का क्रम है)। box का आकार max - min, center (min + max) / 2। unit coordinates की unit है।

• points: (N,3) के अलावा कोई shape हो तो ValueError, खाली point cloud पर भी ValueError (fail-closed)।

• किसी point में NaN हो तो min / max NaN हो जाते हैं (non-finite की जाँच नहीं होती)।

उपयोग: voxelization (occupancy_grid / points_to_voxel का bounds) का क्षेत्र तय करना, और obb (PCA से दिशा मिलाया गया box) से तुलना। axes के साथ न चलने वाली लंबी-पतली वस्तुओं में AABB में बहुत खाली जगह बचती है, इसलिए grasp width के अनुमान के लिए obb के extents का उपयोग करें।

पृष्ठभूमि guides (इस op के पीछे की physics और conventions)

• blender_interop — Blender के साथ उपयोग — shape बनाएँ, fullseye से मापें (सावधानियाँ: axes, units, ground truth)

संदर्भ (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 के स्रोत।

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

• hull_bounds — py -3.11 examples_3d/hull_bounds.py

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

fuse_to_voxel · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · distance_point_line · distance_line_line · distance_segment_segment

इसी category के (bounds)

convex_hull · obb · min_enclosing_sphere


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

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