Constraint Balance 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 linear constraints contribute to mesh structure across the 10, 100, and 1000 km2 bundles. It uses the committed bundle summaries to compute the breakdown without regenerating any mesh.

Constraint balance across mesh scales
Constraint-edge balance across 10, 100, and 1000 km2 mesh bundles.

Case Setup#

  • Three committed bundles (10, 100, 1000 km2) with geology + rivers constraints.

  • Counts extracted from mesh_summary.json for consistency.

  • Focus on linear-constraint balance rather than solver outputs.

What It Shows#

  • How river-edge density compares to geology-interface edges at different scales.

  • How boundary edges contribute to the overall constraint mix.

  • How a compact bar chart can summarize constraints across multiple bundles.

Key Metrics#

  • River edges: 65

  • Geology interfaces: 80

  • Boundary edges: 17

  • Cells: 547

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

Compared Bundle Values#

Field

Meaning

Value

Source

metrics.10 km2 outlet 1

Constraint and cell counts carried by one compared mesh bundle.

river_edges=65, geology_interfaces=80, boundary_edges=17, cells=547

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

metrics.100 km2 outlet 1

Constraint and cell counts carried by one compared mesh bundle.

river_edges=697, geology_interfaces=207, boundary_edges=46, cells=4218

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

metrics.1000 km2 outlet 2

Constraint and cell counts carried by one compared mesh bundle.

river_edges=6739, geology_interfaces=1744, boundary_edges=124, cells=38030

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

Source Pointers#

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

  • examples/projects/07_mesh_gallery/100km2/mesh_headwater_100km2_outlet_1_geology_rivers_buffer30/bundle/mesh_summary.json

  • examples/projects/07_mesh_gallery/1000km2/mesh_1000km2_outlet_2_geology_rivers_buffer30/bundle/mesh_summary.json

  • tools/doc_gallery/update_gallery.py

Artifacts#

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

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