taubin_smooth — 3D mesh_process op

• Data kinds: mesh → mesh

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

उपयोग

Taubin λ|μ filter से non-shrinking smoothing। → (verts, faces)।

हर iteration में "positive lam से खींचने वाला चरण" → "negative mu से वापस धकेलने वाला चरण" लगातार लगाए जाते हैं। |mu| > lam रखने से यह ऐसा band-pass filter बन जाता है जो low frequency (समग्र आकार) को जाने देता है और केवल high frequency (noise) को घटाता है, और Laplacian के shrinkage artifact को निष्प्रभावी करता है (sphere का औसत radius लगभग बना रहता है)। default lam=0.33, mu=-0.34 Taubin (1995) की सिफ़ारिश के क़रीब है।

Args:

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

iters: λ|μ pairs के iterations की संख्या (positive integer)।

lam: खींचने वाले चरण का coefficient, 0 < lam < 1।

mu: वापस धकेलने वाले चरण का coefficient, mu < 0 और |mu| > lam (shrinkage को निष्प्रभावी करने की शर्त)।

Returns:

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

Raises:

ValueError: mesh का shape अमान्य, face index सीमा से बाहर, या iters/lam/mu अमान्य (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)

laplacian_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 न करें)।*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.