Resolution Sensitivity Across Scales#

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 compares how mesh cell areas distribute across the three committed scales. It provides a compact resolution ladder without generating new meshes.

Case Setup#

  • Cell areas read directly from bundle CSVs.

  • Log-scale histograms to compare heterogeneous resolution.

  • Percentile table to summarize each scale.

What It Shows#

  • How cell-area distributions shift with scale.

  • How to summarize resolution sensitivity using percentiles.

  • A reusable template for comparing mesh density across bundles.

Key Metrics#

  • Cells: 547

  • Area p10: 4.47e+03 m2

  • Area median: 3.26e+04 m2

  • Area p90: 2.04e+05 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.10 km2 outlet 1

Committed bundle included in the cross-case mesh comparison.

bundle

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

bundle.100 km2 outlet 1

Committed bundle included in the cross-case mesh comparison.

bundle

examples/projects/07_mesh_gallery/100km2/mesh_headwater_100km2_outlet_1_geology_rivers_buffer30/bundle

bundle.1000 km2 outlet 2

Committed bundle included in the cross-case mesh comparison.

bundle

examples/projects/07_mesh_gallery/1000km2/mesh_1000km2_outlet_2_geology_rivers_buffer30/bundle

Mesh Summary#

Field

Meaning

Value

Source

cell_count

Metric displayed on this page.

547

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

area_p10_m2

Metric displayed on this page.

4.47e+03 m2

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

area_median_m2

Metric displayed on this page.

3.26e+04 m2

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

area_p90_m2

Metric displayed on this page.

2.04e+05 m2

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

Source Pointers#

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

  • examples/projects/07_mesh_gallery/100km2/mesh_headwater_100km2_outlet_1_geology_rivers_buffer30/bundle/cells.csv

  • examples/projects/07_mesh_gallery/1000km2/mesh_1000km2_outlet_2_geology_rivers_buffer30/bundle/cells.csv

  • tools/doc_gallery/update_gallery.py

Artifacts#

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

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