Skip to content

Mesh Quality

The Quality toolbar button (or the Compute Mesh Quality command) computes purely geometric quality metrics for the mesh — no boundary conditions or solver required — inspired by Kratos' ComputeMeshQualityProcess.

The Mesh Quality panel: verdict header, per-metric min/mean/max, band bars, and histograms, over the 3D mesh

The metrics

Every element is scored on four metrics:

MetricMeaning
Aspect / edge ratioRatio of longest to shortest edge (or the element aspect ratio) — high values flag stretched, sliver elements.
Min angleSmallest dihedral angle (volume cells) or interior corner angle (surface cells). Small angles degrade solver conditioning.
Max angleLargest dihedral / corner angle — values near 180° flag near-degenerate cells.
Size gradationHow abruptly element size changes from one node to its neighbours — large jumps mean an uneven mesh.

The thresholds that separate the bands mirror the Kratos defaults.

Why "purely geometric"?

BC- and flag-dependent checks (dead-tetrahedra, gap / hole detection) are intentionally omitted — they are undefinable for a mesh viewed without its analysis context. Everything reported here depends only on node coordinates and connectivity.

Reading the panel

Each metric is one card containing:

  • a min · mean · max line,
  • a stacked band bar — the fraction of elements that are Good, Acceptable, Bad, or Unacceptable,
  • a histogram of the metric across all elements.

The header shows an overall verdict — Mesh quality criteria satisfied (green) or a warning — and how many elements were analysed. In the example above, 62,980 tetrahedra score 99.9 % Good on aspect ratio, with no bad elements.

Highlighting bad elements

When a metric has elements in the Bad / Unacceptable bands, its card gains a Highlight bad (N) button. Click it to build a red overlay layer of exactly those elements in the 3D view, and Frame to zoom to them — so you can find and inspect problem cells directly. Click again (or Frame on another metric) to move the highlight; closing the panel clears it.

Released under the GNU AGPL-3.0-or-later License.