Calibration Twin: Dupuit Posterior 1D#

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.

Same-solver posterior-oriented twin benchmark on dupuit_fixed_head_1d with one scalar K value and distribution-valued methods.

  • success_metric=distribution

  • meets_target=True

  • truth_recovered=True

  • cost=0.063018

  • n_eval=18

  • calibration=3.007 s

  • candidate runtime=2.762 s

  • algorithm overhead=0.2456 s

  • actualize=0 s

  • launcher prep=0 s

  • runtime patch=0 s

  • simulate=0.1534 s

  • output select=0 s

  • objective score=0 s

  • success_metric=best_fit_or_distribution

  • meets_target=True

  • truth_recovered=True

  • cost=0.0674665

  • n_eval=18

  • calibration=3.047 s

  • candidate runtime=2.735 s

  • algorithm overhead=0.3124 s

  • actualize=0 s

  • launcher prep=0 s

  • runtime patch=0 s

  • simulate=0.1519 s

  • output select=0 s

  • objective score=0 s

  • success_metric=best_fit

  • meets_target=True

  • truth_recovered=True

  • cost=0.0202463

  • n_eval=18

  • calibration=3.639 s

  • candidate runtime=3.343 s

  • algorithm overhead=0.2961 s

  • actualize=0 s

  • launcher prep=0 s

  • runtime patch=0 s

  • simulate=0.1857 s

  • output select=0 s

  • objective score=0 s

  • success_metric=distribution

  • meets_target=True

  • truth_recovered=True

  • cost=0.00087097

  • n_eval=11

  • calibration=34.87 s

  • candidate runtime=2.421 s

  • algorithm overhead=32.44 s

  • actualize=0 s

  • launcher prep=0 s

  • runtime patch=0 s

  • simulate=0.2201 s

  • output select=0 s

  • objective score=0 s

  • success_metric=distribution

  • meets_target=True

  • truth_recovered=True

  • cost=0.94815

  • n_eval=6

  • posterior_samples=6

  • calibration=2.058 s

  • candidate runtime=1.669 s

  • algorithm overhead=0.3891 s

  • actualize=0 s

  • launcher prep=0 s

  • runtime patch=0 s

  • simulate=0.2782 s

  • output select=0 s

  • objective score=0 s

Case Setup#

  • Solver: modflow6 in steady regime.

  • Benchmark family: Supplementary Scalar Reference Cases.

  • Truth parameters: K_global.

  • Observed outputs: q_east.

  • Benchmarked methods: random_search, optuna, cma_es, gp_mapping, da_mh_gp.

  • Initial bounds widened to: K_global=[5e-05, 0.0003].

What It Shows#

  • A same-solver twin experiment where synthetic observations are generated first, then recovered through calibration on the same physics stack.

  • A case-level configuration figure, an objective trace, and an objective landscape or pairwise projection for the selected display method.

  • Per-method timing diagnostics with total calibration time plus average per-model preparation, simulation, and objective-evaluation costs.

How To Read It#

  • Open case_configuration.png first to understand the parameter block, outputs, and weighting before reading the optimization figures.

  • Use objective_trace to judge convergence speed and objective_landscape to see where the evaluated candidates concentrate relative to the truth and the selected solution(s).

  • Read timing metrics as benchmark diagnostics, not as universal solver performance numbers: they depend on the chosen method, case size, and evaluation budget.

Key Metrics#

  • Methods: 4

  • Display method: da_mh_gp

  • Posterior samples: 53

  • Calibration total: 34.49 s

  • Session prep: 36.19 s

  • Candidate runtime: 32.34 s

  • Algorithm overhead: 2.15 s

  • Model total: 0.6101 s

  • Actualize: 0.01359 s

  • Launcher prep: 0.01359 s

  • Runtime patch: 0 s

  • Model prep: 0.01359 s

  • Model sim: 0.5965 s

  • Output select: 0 s

  • Objective score: 0 s

Next Steps#

  • Compare this case with the other calibration gallery pages to see how deterministic and distribution-valued methods behave under different inverse problems.

  • Use the full benchmark suite in validation_cases/calibration when you need multi-seed comparisons or noisy variants beyond the curated gallery subset.

Reproduce#

Run the underlying example or validation case with:

python -m validation_cases.calibration.twin.steady.dupuit_fixed_head_1d.run_case --case posterior

Refresh the committed gallery artifacts with:

python -m tools.doc_gallery

Case Parameters#

Benchmark Setup#

Field

Meaning

Value

Source

solver_name

Solver family used both to generate synthetic observations and to calibrate candidates.

modflow6

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

regime

Flow regime exercised by the inverse benchmark.

steady

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

output_names

Observables extracted from each candidate simulation and used in the composite objective.

q_east

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

observation_noise

Synthetic noise injected after the truth run, if any.

none

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

evaluation_budget

Approximate per-method evaluation budget used by the gallery generator when set.

18

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

Calibrated Parameters#

Field

Meaning

Value

Source

K_global

Truth value, initial search interval, and acceptance tolerance for this calibrated parameter.

truth=0.0001, bounds=5e-05, 0.0003, tolerance=2e-05

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

Methods And Timing#

Field

Meaning

Value

Source

random_search

Method result summary including target status, evaluation count, total time, and mean per-model actualize / launcher / simulation / objective timings.

meets_target=true, cost=0.063018, n_eval=18, calib_s=16.5704, candidate_runtime_s=16.3955, algorithm_overhead_s=0.174829, actualize_s=0.0134783, launcher_prep_s=0.0134783, runtime_patch_s=0, model_sim_s=0.897385, output_select_s=0, objective_score_s=0

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

cma_es

Method result summary including target status, evaluation count, total time, and mean per-model actualize / launcher / simulation / objective timings.

meets_target=true, cost=0.0202463, n_eval=18, calib_s=13.9007, candidate_runtime_s=13.7326, algorithm_overhead_s=0.168079, actualize_s=0.0155141, launcher_prep_s=0.0155141, runtime_patch_s=0, model_sim_s=0.747408, output_select_s=0, objective_score_s=0

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

gp_mapping

Method result summary including target status, evaluation count, total time, and mean per-model actualize / launcher / simulation / objective timings.

meets_target=true, cost=0.0246078, n_eval=12, calib_s=28.3355, candidate_runtime_s=9.06499, algorithm_overhead_s=19.2705, actualize_s=0.0152977, launcher_prep_s=0.0152977, runtime_patch_s=0, model_sim_s=0.740118, output_select_s=0, objective_score_s=0

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

da_mh_gp

Method result summary including target status, evaluation count, total time, and mean per-model actualize / launcher / simulation / objective timings.

meets_target=true, cost=0.94815, n_eval=53, posterior_samples=53, calib_s=34.4863, candidate_runtime_s=32.3367, algorithm_overhead_s=2.14967, actualize_s=0.0135867, launcher_prep_s=0.0135867, runtime_patch_s=0, model_sim_s=0.596539, output_select_s=0, objective_score_s=0

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

Displayed Metrics#

Field

Meaning

Value

Source

method_count

Metric surfaced on the gallery page for the selected display method.

4

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

display_method_name

Metric surfaced on the gallery page for the selected display method.

da_mh_gp

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

posterior_sample_count

Metric surfaced on the gallery page for the selected display method.

53

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

calibration_time_seconds

Metric surfaced on the gallery page for the selected display method.

34.49 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

session_prepare_time_seconds

Metric surfaced on the gallery page for the selected display method.

36.19 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

estimated_candidate_runtime_seconds

Metric surfaced on the gallery page for the selected display method.

32.34 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

algorithm_overhead_time_seconds

Metric surfaced on the gallery page for the selected display method.

2.15 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

mean_candidate_total_time_seconds

Metric surfaced on the gallery page for the selected display method.

0.6101 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

mean_candidate_actualize_time_seconds

Metric surfaced on the gallery page for the selected display method.

0.01359 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

mean_candidate_launcher_prepare_time_seconds

Metric surfaced on the gallery page for the selected display method.

0.01359 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

mean_candidate_runtime_patch_time_seconds

Metric surfaced on the gallery page for the selected display method.

0 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

mean_candidate_preparation_time_seconds

Metric surfaced on the gallery page for the selected display method.

0.01359 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

mean_candidate_simulation_time_seconds

Metric surfaced on the gallery page for the selected display method.

0.5965 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

mean_candidate_output_selection_time_seconds

Metric surfaced on the gallery page for the selected display method.

0 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

mean_candidate_objective_compute_time_seconds

Metric surfaced on the gallery page for the selected display method.

0 s

docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6_summary.json

Source Pointers#

  • validation_cases/calibration/README.md

  • validation_cases/calibration/run_benchmarks.py

  • validation_cases/calibration/plotting.py

  • validation_cases/calibration/shared/definitions.py

  • validation_cases/calibration/shared/runtime.py

  • validation_cases/calibration/twin/steady/dupuit_fixed_head_1d/run_case.py

  • validation_cases/calibration/twin/steady/dupuit_fixed_head_1d/experiment.py

  • hydromodpy/calibration/cli.py

  • hydromodpy/calibration/engine.py

Artifacts#

  • docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6__configuration.png

  • docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6__random_search_landscape.png

  • docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6__random_search_trace.png

  • docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6__cma_es_landscape.png

  • docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6__cma_es_trace.png

  • docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6__gp_mapping_landscape.png

  • docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6__gp_mapping_trace.png

  • docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6__da_mh_gp_landscape.png

  • docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6__da_mh_gp_trace.png

  • docs/readthedocs/source/_static/capability_gallery/calibration/calibration_twin_dupuit_fixed_head_posterior_modflow6__da_mh_gp_posterior.png

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