aabb — 3D bounds op

• Datenarten: points → primitive

• Aufruf: import fullseye as fs; fs.ledger.aabb(points) (die Implementierung direkt: import pcseg; pcseg.aabb(points); aus dem Register: ops3d.get("aabb"))

Verwendung

Achsenparallele Bounding Box. Liefert (min (3,), max (3,)).

Gibt Minimum und Maximum jeder Achse der Punktwolke unverändert zurück (P.min(0), P.max(0)). Der Rückgabewert sind 2 (3,)- float64-Arrays, in der Reihenfolge (xmin, ymin, zmin) und (xmax, ymax, zmax) (die Achsenreihenfolge ist die Spaltenreihenfolge der Eingabe). Die Boxgröße ist max - min, der Mittelpunkt (min + max) / 2. Die Einheit ist die Koordinateneinheit.

• points: andere Formen als (N,3) ergeben ValueError, eine leere Punktwolke ebenfalls ValueError (fail-closed).

• Enthält ein Punkt NaN, werden min / max zu NaN (keine Prüfung auf nicht endliche Werte).

Verwendung: Festlegen des Bereichs für die Voxelisierung (bounds von occupancy_grid / points_to_voxel), Vergleich mit obb (per PCA ausgerichtete Box). Bei länglichen, nicht achsparallelen Objekten hat die AABB viel Überschuss, daher für die Schätzung der Greifbreite die extents von obb verwenden.

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• blender_interop — Zusammen mit Blender — Form bauen, mit fullseye messen (Fallstricke: Achsen, Einheiten, Referenzdaten)

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• hull_bounds — py -3.11 examples_3d/hull_bounds.py

Typkompatible Folge-Operatoren (nehmen primitive als Eingabe)

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

Gleiche Kategorie (bounds)

convex_hull · obb · min_enclosing_sphere


*Provenance: pcseg.py — 3D Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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