laplacian_smooth — 3D mesh_process op

• Datenarten: mesh → mesh

• Aufruf: import fullseye as fs; fs.ledger.laplacian_smooth(mesh: 'Sequence', iters: 'int' = 10, lam: 'float' = 0.5) -> 'Mesh' (die Implementierung direkt: import mesh_smooth; mesh_smooth.laplacian_smooth(mesh: 'Sequence', iters: 'int' = 10, lam: 'float' = 0.5) -> 'Mesh'; aus dem Register: ops3d.get("laplacian_smooth"))

Verwendung

Glättung von Dreiecksnetzen mit dem Umbrella-Laplace-Operator. → (verts, faces).

Jede Iteration aktualisiert alle Ecken als v_i += lam * (mean(隣接 v_j) - v_i). Hochfrequentes Rauschen wird zuverlässig reduziert, auf einer geschlossenen Fläche aber schrumpft sie nach innen (shrinkage), wie beim mittleren Krümmungsfluss (eine Kugel schrumpft mit den Iterationen). Um das Schrumpfen zu vermeiden, taubin_smooth verwenden.

Args:

mesh: Sequenz aus (verts (N,3), faces (M,3)[, ...]). faces bleiben unverändert.

iters: Anzahl der Iterationen (positive ganze Zahl).

lam: Zugrate pro Schritt, 0 < lam <= 1 (1 zieht ganz auf den Nachbarmittelwert).

Returns:

(verts (N,3) float64, faces (M,3) int64). faces werden aus der Eingabe übernommen.

Raises:

ValueError: ungültige Mesh-Form, Flächenindex außerhalb des Bereichs oder ungültige iters/lam (fail-closed).

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_smooth — py -3.11 examples_3d/mesh_smooth.py

Typkompatible Folge-Operatoren (nehmen mesh als Eingabe)

mesh_to_voxel · mesh_to_points · to_points · fuse_to_voxel · ambient_occlusion · cast_shadow · supersample_mesh · render_beauty

Gleiche Kategorie (mesh_process)

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


*Provenance: mesh_smooth.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.