laplacian_smooth — 3D `mesh_process` op

• Data kinds: mesh → mesh

• Call: import fullseye as fs; fs.ledger.laplacian_smooth(mesh: 'Sequence', iters: 'int' = 10, lam: 'float' = 0.5) -> 'Mesh' (implementation को सीधे call करना हो तो import mesh_smooth; mesh_smooth.laplacian_smooth(mesh: 'Sequence', iters: 'int' = 10, lam: 'float' = 0.5) -> 'Mesh', registry से लेना हो तो ops3d.get("laplacian_smooth"))

उपयोग

umbrella Laplacian से triangle mesh smoothing। → (verts, faces)।

हर iteration में सभी vertices को v_i += lam * (mean(隣接 v_j) - v_i) से update किया जाता है। यह high-frequency noise को भरोसेमंद ढंग से घटाता है, पर closed surface पर mean curvature flow की तरह अंदर की ओर सिकुड़ता (shrinkage) है (sphere iterations के साथ छोटा होता जाता है)। shrinkage से बचना हो तो taubin_smooth का उपयोग करें।

Args:

mesh: (verts (N,3), faces (M,3)[, ...]) का sequence। faces नहीं बदलते।

iters: iterations की संख्या (positive integer)।

lam: हर चरण का खिंचाव अनुपात, 0 < lam <= 1 (1 पर पड़ोसियों के औसत तक पूरा खिंचाव)।

Returns:

(verts (N,3) float64, faces (M,3) int64)। faces input से ही रखे जाते हैं।

Raises:

ValueError: mesh का shape अमान्य, face index सीमा से बाहर, या iters/lam अमान्य (fail-closed)।

पृष्ठभूमि guides (इस op के पीछे की physics और conventions)

• blender_interop — Blender के साथ उपयोग — shape बनाएँ, fullseye से मापें (सावधानियाँ: axes, units, ground truth)

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• mesh_smooth — py -3.11 examples_3d/mesh_smooth.py

वे अगले ops जिनसे type जुड़ता है (`mesh` को input के रूप में लेते हैं)

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

इसी category के (`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. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

laplacian_smooth — 3D mesh_process op