Skip to content

DZTR 0.3.0

Choose a tag to compare

@fuadyassin fuadyassin released this 23 Oct 23:26

DZTR 0.3.0 provides a researcher workflow for estimating reservoir operating
targets, calibrating them where observations exist, and applying frozen profiles
in hydrological models.

  • Data-availability routes for storage and release, release only, storage only,
    and neither response, with documented assumptions and provenance.
  • Level-to-storage preparation with explicit datum/reference and geometry choices.
  • Wet, dry and normal calibration-year selection with at least 65% support;
    joint NSGA-II, scalar DDS and optional GA calibration; persistent checkpoints.
  • Public dztr commands, source orchestration and independently installed-wheel
    application. Frozen examples cover Gardiner, Oahe and Garrison.

Installation, public parameter generation, exact historical/restart reproduction,
water balance and sealed resume are checked on Ubuntu 24.04 and Windows 2022
with Python 3.12.7. The complete local Windows regression suite passed 1,854 tests
with one skip. release_evidence.json identifies the source commit, CI run,
environments and checks. No new calibration searches were needed for this release.

Use the source ZIP for the complete workflow and examples; the wheel supports
frozen-profile simulation. Install Python dependencies separately. The
documentation ZIP is a static-site snapshot; SHA256SUMS.txt seals each file.

Documentation: https://fuadyassin.github.io/DZTR_model/

The four-route assessment compares the same 27 successful, scored reservoirs
across all routes. It documents weaker storage behavior when storage is hidden.
The experiment uses conditional forcing and limited calibration budgets. Software
reproducibility does not establish independent forecast skill, source certification
or optimizer convergence. Regional donors, approximate geometry and source-gated
reservoirs retain their stated qualifications. Private archives are excluded;
only the approved public reservoir examples are distributed.

License: MIT for software and documentation; third-party input terms remain
applicable. Cite this software with CITATION.cff and cite the model paper
separately: https://doi.org/10.5194/hess-23-3735-2019.

Software DOI (v0.3.0): https://doi.org/10.5281/zenodo.23606593

All-versions DOI: https://doi.org/10.5281/zenodo.23606592

Zenodo archives the full tagged public source. All 676 archived files were
verified against the frozen v0.3.0 Git tag. The wheel, allowlisted application
bundle, rendered documentation and checksums are the GitHub release assets.
The original tag and eight sealed files retain their original bytes and hashes.
The software DOI is separate from the model-paper DOI.