face_areas — 3D `mesh_process` op

• Data kinds: mesh → signal

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

उपयोग

triangle mesh का हर face का area → (M,)।

हर face के लिए area = 0.5·|cross(v1−v0, v2−v0)| लौटाता है (mesh_area इनका योग है)। area को weights के रूप में इस्तेमाल करने के लिए दिया जाता है —— "नीचे की ओर मुड़े faces का area", "tolerance से बाहर का area" और "curvature का area-weighted mean" सभी ऐसी मात्राएँ हैं जिनके लिए हर face का area चाहिए, और इन्हें योग से नहीं बनाया जा सकता।

Args:

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

Returns:

(M,) का float64 (non-negative)। क्रम faces का क्रम है, जो face_normals वाला ही

क्रम है, इसलिए areas[normals[:, 2] < 0].sum() की तरह सीधे जोड़ा जा सकता है।

Raises:

ValueError: जब mesh (vertices, faces) के 2 elements न हो, shape अमान्य हो,

coordinates non-finite हों, index non-integer या सीमा से बाहर हो, या mesh खाली हो।

ध्यान दें: mesh_area की तरह, degenerate triangles (area 0) को reject नहीं किया जाता, 0 लौटाया जाता है (face_normals इन्हें reject करता है क्योंकि normal परिभाषित नहीं होता —— वही mesh यहाँ पास हो जाता है)। duplicate faces और आगे-पीछे 2 परतों वाले faces हर एक 1 face के रूप में गिने जाते हैं। 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 करते हैं)

• mesh_props — py -3.11 examples_3d/mesh_props.py

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

fuse_to_voxel

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

face_areas — 3D mesh_process op