Validation and Quality

Tools for assessing mesh integrity and element quality.

Validation (validate_mesh())

Checks structural correctness: valid index ranges, consistent dimensions, proper data types, and data shape compatibility. Returns a report of any errors found. Also accessible as mesh.validate().

Quality metrics (compute_quality_metrics())

Per-cell geometric quality indicators including aspect ratio, minimum/maximum angles, edge length ratios, and an overall quality score. Returned as a TensorDict. Also accessible as mesh.quality_metrics.

Statistics (compute_mesh_statistics())

Aggregate summaries (min, max, mean, std) of geometric quantities across the entire mesh: edge lengths, cell areas, angles, and quality scores. Also accessible as mesh.statistics.

from physicsnemo.mesh.primitives.surfaces import sphere_icosahedral

mesh = sphere_icosahedral.load(subdivisions=2)

# Validate structural integrity
report = mesh.validate()

# Per-cell quality
quality = mesh.quality_metrics
print(quality["quality_score"].mean())

# Aggregate statistics
stats = mesh.statistics

API Reference

Mesh validation, quality metrics, and statistics.

This module provides tools for validating mesh integrity, computing quality metrics, and generating mesh statistics.