mesh_to_points — 3D `transform` op

• Datenarten: mesh → points

• Aufruf: import fullseye as fs; fs.ledger.mesh_to_points(vertices, faces, samples=20000, seed=0) (die Implementierung direkt: import match3d; match3d.mesh_to_points(vertices, faces, samples=20000, seed=0); aus dem Register: ops3d.get("mesh_to_points"))

Verwendung

Mesh (Vertices + Faces) → eine Oberflächenpunktmenge (flächengewichtet gleichverteilt). Die Mesh-→-Punktwolke-Umwandlung.

Ablauf: Die Fläche 0.5·|(b−a)×(c−a)| jedes Dreiecks tri = vertices[faces] dient als Wahrscheinlichkeit, samples Flächen werden mit Zurücklegen gezogen, auf jeder Fläche wird u, v ~ U(0,1) gezogen und bei u + v > 1 auf (1−u, 1−v) zurückgefaltet (gleichverteilt baryzentrisch). Punkt = a + u(b−a) + v(c−a). seed fixiert default_rng, daher ergeben gleiche Argumente dieselbe Punktwolke.

• vertices (V,3) float, faces (F,3) int (Vertex-Indizes ab 0).

• Rückgabewert (samples, 3) float64. Genau samples Punkte, unabhängig von der Anzahl der Flächen.

• Sind alle Flächen degeneriert (Flächensumme 0), werden die Wahrscheinlichkeiten NaN und rng.choice wirft ValueError.

• Normalen werden nicht mitgeliefert (mit estimate_point_normals ergänzen). Wegen der Flächengewichtung erhalten größere Flächen mehr Punkte;

von der Vertexdichte hängt das Ergebnis nicht ab.

Nachgelagert: points_to_voxel / icp_point2point_3d / match_pca.

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)

• mesh_decimate — py -3.11 examples_3d/mesh_decimate.py

Typkompatible Folge-Operatoren (nehmen `points` als Eingabe)

points_to_voxel · gaussians_to_voxel · estimate_point_normals · to_points · match_points_ncc · match_pca · moment_axes · icp_point2point_3d

Gleiche Kategorie (`transform`)

points_to_voxel · gaussians_to_voxel · mesh_to_voxel · depth_to_points · voxel_to_mips · voxel_to_mesh · tsdf_from_depth · signed_distance_field

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

mesh_to_points — 3D transform op