fit_plane_3d — 3D `geometry` op

• Datenarten: points → primitive

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

Verwendung

Punktmenge → eine Kleinste-Quadrate-Ebene (durch den Schwerpunkt, Normale = kleinste Hauptachse, plus RMS-Residuum). Liefert (point, normal, resid).

Nimmt den Schwerpunkt c einer (N,3)-Punktwolke (ValueError, wenn nicht 3 Spalten oder unter 3 Punkten) und verwendet den Eigenvektor zum kleinsten Eigenwert der Streumatrix als Normale (minimiert die Summe der quadrierten orthogonalen Abstände; resid = sqrt(λ_min/N) = RMS des orthogonalen Abstands von der Ebene). normal ist ein Einheitsvektor mit beliebigem Vorzeichen (für eine Ausrichtung nach außen je nach Blickpunkt oder Schwerpunkt umdrehen). Bei 3 Punkten verläuft die Ebene exakt durch sie, resid=0 (negative BLAS-Rundung wird auf 0 geclampt). Liegen die Punkte auf einer Geraden (auch der 2. Eigenwert ist 0), ist die Normale unbestimmt. Empfindlich gegenüber Ausreißern (vorher Inlier mit ransac_plane / plane_segmentation bestimmen). Nur 3-D.

Nachfolgend: distance_point_plane / angle_between_planes / intersect_planes; für die Ebenheit eines Höhenfelds surface_form_error(degree=1).

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)

• geometry_metrology — py -3.11 examples_3d/geometry_metrology.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 (`geometry`)

line_from_2points · plane_from_3points · angle_3points · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · distance_point_line

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

fit_plane_3d — 3D geometry op