vertex_normals — 3D `mesh_process` op

• Datenarten: mesh → normals

• Aufruf: import fullseye as fs; fs.ledger.vertex_normals(mesh) -> 'np.ndarray' (die Implementierung direkt: import mesh_props; mesh_props.vertex_normals(mesh) -> 'np.ndarray'; aus dem Register: ops3d.get("vertex_normals"))

Verwendung

Die Vertexnormalen eines Dreiecksnetzes (flächengewichtet aggregierte Einheitsnormalen). → (N,3).

Der Kreuzproduktvektor jedes Dreiecks (= Flächennormale × 2·Fläche) wird per Scatter-Add auf seine 3 Ecken addiert und dann je Ecke normiert. Das ergibt einen flächengewichteten Mittelwert, bei dem größere (wichtigere) Flächen mehr beitragen, und die Orientierung ist konsistent mit dem Umlauf der Flächen. Anders als normals_orient.estimate_normals (Punktwolken-PCA, Vorzeichen unbestimmt) ist kein zusätzlicher Orientierungsschritt nötig.

Args:

mesh: Tupel aus (vertices (N,3), faces (M,3)).

Returns:

(N,3) Einheits-Eckennormalen.

Raises:

ValueError: ungültige Form, Index außerhalb des Bereichs oder wenn es eine Ecke gibt, deren Normale nicht definiert werden kann (keine anliegende Fläche /

Beiträge heben sich zu null auf).

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)

• mesh_props — py -3.11 examples_3d/mesh_props.py

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

icp_point2plane · compute_fpfh · shot_descriptor · fuse_to_voxel · reflect · refract · normal_consistency · ransac_cylinder

Gleiche Kategorie (`mesh_process`)

laplacian_smooth · taubin_smooth · decimate_qem · face_normals · mesh_area · vertex_curvature · face_areas · mesh_volume

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

vertex_normals — 3D mesh_process op