Eve library

ISIS V2 Mesh Quality Validators

Guide

Revision 1

On this page

WS06-002 introduces deterministic mesh quality validation in @isis/3d-generation via src/processing/mesh-quality-validator.ts.

Implemented Validators#

  • manifold check
    • Builds edge topology and detects non-manifold edges.
    • Reports boundary edge count alongside manifold status.
  • non-zero area check
    • Computes per-triangle area and flags degenerate/near-zero faces.
    • Configurable area epsilon (minTriangleArea).
  • self-intersection heuristics
    • Deterministic pairwise triangle AABB-overlap sampling (non-adjacent faces).
    • Configurable sampling budget and ratio threshold.

API#

  • validateMeshQuality(mesh, options)
    • Input: UnifiedMeshData
    • Output: MeshQualityValidationResult with:
      • manifold metrics
      • nonZeroArea metrics
      • selfIntersection heuristic metrics
      • normalized issues list with thresholds and severities

Defaults#

  • minTriangleArea: 1e-10
  • maxZeroAreaTriangleRatio: 0
  • maxSelfIntersectionRatio: 0.02
  • maxSelfIntersectionChecks: 20000