newton.utils.validate_tet_mesh#

newton.utils.validate_tet_mesh(vertices, indices, *, min_volume=1e-9, min_eta=0.01, label=None, stacklevel=2)[source]#

Check a tetrahedral mesh for quality issues and emit warnings.

Inspects the input tet mesh for inverted elements, small volumes, sliver tetrahedra, and non-manifold faces. Each detected problem is reported via warnings.warn().

The shape quality metric used is:

\[\eta = \frac{12\,(3\,|V|)^{2/3}}{\sum_i l_i^2}\]

where V is the signed volume and l_i are the six edge lengths. For a regular tetrahedron \(\eta = 1\); degenerate elements approach zero.

Parameters:

vertices (ndarray) – Vertex positions [m], shape (N, 3).
indices (ndarray) – Tetrahedron vertex indices, shape (T, 4).
min_volume (float) – Minimum absolute tet volume [m³]. Default 1e-9 (1 mm³).
min_eta (float) – Minimum shape quality eta. Default 0.01.
label (str | None) – Optional name included in the warning message so callers can identify which mesh tripped the warning when validating many meshes.
stacklevel (int) – Passed to warnings.warn().