face_areas — 3D `mesh_process` op

• Datenarten: mesh → signal

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

Verwendung

Fläche jeder Facette eines Dreiecksnetzes → (M,).

Gibt die Fläche = 0.5·|cross(v1−v0, v2−v0)| je Fläche zurück (mesh_area ist deren Summe). Die Flächen sind dazu da, als Gewichte verwendet zu werden -- "die Fläche der nach unten zeigenden Flächen", "die Fläche außerhalb der Toleranz" und "der flächengewichtete Mittelwert der Krümmung" sind allesamt Größen, die Flächen je Fläche benötigen und nicht aus der Summe gebildet werden können.

Args:

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

Returns:

(M,) float64 (nichtnegativ). Die Reihenfolge ist die von faces, dieselbe

Anordnung wie bei face_normals, sodass sie sich direkt kombinieren lassen, etwa areas[normals[:, 2] < 0].sum().

Raises:

ValueError: wenn mesh nicht die 2 Elemente (vertices, faces) sind, die Form ungültig ist,

Koordinaten nicht endlich sind, ein Index nicht ganzzahlig oder außerhalb des Bereichs ist oder es leer ist.

Hinweis: Wie bei mesh_area werden degenerierte Dreiecke (Fläche 0) nicht abgewiesen, sondern liefern 0 (face_normals weist sie ab, weil die Normale undefiniert ist -- dasselbe Mesh geht hier durch). Doppelte Flächen und beidseitig belegte Flächen (2 Lagen, Vorder- und Rückseite) zählen jeweils als 1 Fläche. Die Einheit ist das Quadrat (Potenz 2) der Koordinateneinheit.

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 `signal` als Eingabe)

fuse_to_voxel

Gleiche Kategorie (`mesh_process`)

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

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

face_areas — 3D mesh_process op