Mesh Quality Diagnostics (10 km2)#

Note

This page and its static assets are auto-generated by python -m tools.doc_gallery. The Sphinx build only reads committed PNG and JSON artifacts.

This case computes basic triangle-shape diagnostics from the versioned bundle and renders compact maps plus histograms. It targets mesh-quality checks that can be shared in documentation without re-running a mesh generation pipeline.

Mesh quality diagnostics for the 10 km2 catchment mesh
Triangle quality diagnostics for the 10 km2 Naizin mesh bundle.

Case Setup#

  • Bundle: 10 km2 Strahler-3 outlet 1 with geology + river constraints.

  • Triangle-based quality diagnostics computed directly from nodes/cells CSVs.

  • Percentiles summarized to keep the figure readable in docs.

What It Shows#

  • Where the smallest angles and largest aspect ratios concentrate on the mesh.

  • How triangle areas distribute across one catchment-scale mesh.

  • What percentile-based quality summaries look like for documentation use.

Key Metrics#

  • Triangle cells: 547

  • Min angle (p05): 23.8 deg

  • Aspect ratio (p95): 2.37

  • Area (p05): 3.63e+03 m2

Reproduce#

Run the underlying example or validation case with:

python -m tools.doc_gallery

Refresh the committed gallery artifacts with:

python -m tools.doc_gallery

Case Parameters#

Bundle Inputs#

Field

Meaning

Value

Source

bundle_path

Versioned bundle used to compute or display the mesh-focused figure.

bundle

examples/projects/07_mesh_gallery/10km2/mesh_s3_10km2_outlet_1_geology_rivers_buffer30/bundle

Mesh Summary#

Field

Meaning

Value

Source

triangle_cell_count

Metric displayed on this page.

547

docs/source/_static/capability_gallery/mesh/mesh_quality_diagnostics_naizin_10km2_summary.json

min_angle_p05_deg

Metric displayed on this page.

23.8 deg

docs/source/_static/capability_gallery/mesh/mesh_quality_diagnostics_naizin_10km2_summary.json

aspect_ratio_p95

Metric displayed on this page.

2.37

docs/source/_static/capability_gallery/mesh/mesh_quality_diagnostics_naizin_10km2_summary.json

area_p05_m2

Metric displayed on this page.

3.63e+03 m2

docs/source/_static/capability_gallery/mesh/mesh_quality_diagnostics_naizin_10km2_summary.json

Source Pointers#

  • examples/projects/07_mesh_gallery/10km2/mesh_s3_10km2_outlet_1_geology_rivers_buffer30/bundle/nodes.csv

  • examples/projects/07_mesh_gallery/10km2/mesh_s3_10km2_outlet_1_geology_rivers_buffer30/bundle/cells.csv

  • examples/projects/07_mesh_gallery/10km2/mesh_s3_10km2_outlet_1_geology_rivers_buffer30/bundle/mesh_summary.json

  • tools/doc_gallery/update_gallery.py

Artifacts#

  • docs/source/_static/capability_gallery/mesh/mesh_quality_diagnostics_naizin_10km2.png

  • docs/source/_static/capability_gallery/mesh/mesh_quality_diagnostics_naizin_10km2_summary.json stores the displayed metrics plus source hashes used by python -m tools.doc_gallery --check.