mesh_area — 3D `mesh_process` op

• Data kinds: mesh → measurement

• Call: import fullseye as fs; fs.ledger.mesh_area(mesh) -> 'float' (implementation को सीधे call करना हो तो import mesh_props; mesh_props.mesh_area(mesh) -> 'float', registry से लेना हो तो ops3d.get("mesh_area"))

उपयोग

triangle mesh का surface area (सभी triangles के area का योग)। → float।

area = Σ 0.5·|cross(v1−v0, v2−v0)|। यह vertex count को किसी constant से गुणा करने वाला सरल approximation नहीं है, बल्कि असली faces के आकार को जोड़ता है, इसलिए mesh के scale और shape के साथ सही ढंग से चलता है।

Args:

mesh: (vertices (N,3), faces (M,3)) का tuple।

Returns:

surface area (non-negative float)।

Raises:

ValueError: जब mesh (vertices, faces) के 2 elements न हो, shape अमान्य हो, coordinates non-finite हों, index non-integer या

सीमा से बाहर हो, mesh खाली हो, या कोई ऐसा triangle हो जिसके 3 vertices में से कोई एक ही index वाले हों।

ध्यान दें: face_normals के विपरीत, लगभग एक सीधी रेखा पर पड़े coordinates वाला degenerate triangle (area 0) reject नहीं होता, बल्कि 0 के रूप में जोड़ा जाता है। duplicate faces और आगे-पीछे 2 परतों वाले faces जैसे हैं वैसे 2 बार गिने जाते हैं। unit coordinate unit का वर्ग (घात 2) है।

पृष्ठभूमि 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 करते हैं)

• dl_mesh_curvature — py -3.11 examples_3d/dl_mesh_curvature.py

• mesh_props — py -3.11 examples_3d/mesh_props.py

• minimal_surfaces — py -3.11 examples_3d/minimal_surfaces.py

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

vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle

इसी category के (`mesh_process`)

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

*Provenance: mesh_props.py — 3D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

mesh_area — 3D mesh_process op