Checking for missing content type metadata ...

Checking for non-preferred file/folder path names (may take a long time depending on the number of files/folders) ...

Code, model outputs, and interactive supplement for Shifting runoff sources shape wetted channel length-discharge hysteresis


Authors:
Owners: This resource does not have an owner who is an active HydroShare user. Contact CUAHSI (help@cuahsi.org) for information on this resource.
Type: Resource
Storage: The size of this resource is 33.8 MB
Created: Sep 13, 2026 at 8:08 p.m. (UTC)
Last updated: Sep 15, 2026 at 8:01 p.m. (UTC) (Metadata update)
Published date: Sep 15, 2026 at 8:01 p.m. (UTC)
DOI: 10.4211/hs.adbb73bdeac14273af3da9dc9c49ccd0
Citation: See how to cite this resource
Content types: CSV Content 
Sharing Status: Published
Views: 128
Downloads: 21
+1 Votes: Be the first one to 
 this.
Comments: No comments (yet)

Abstract

This resource accompanies "Shifting runoff sources shape wetted channel length-discharge hysteresis" by David N. Dralle, Dana A. Lapides, and W. Jesse Hahm. It contains the Python code, synthetic model outputs, figure, and interactive HTML supplement used to examine how changing runoff-source patterns alter wetted channel extent at a given outlet discharge.

The model combines simultaneous, upstream-moving, or downstream-moving recharge with spatial differences in hillslope drainage. Six scenarios illustrate how these processes reinforce or oppose one another, changing the direction and width of L-Q hysteresis under instantaneous routing and fixed wetting thresholds.

The standalone HTML runs offline and supports parameter exploration, CSV downloads, and video export. All inputs are synthetic. The paper figure uses 30 discrete sources; the interactive supplement defaults to 600 finite-area cells. The README provides run instructions, file descriptions, and units.

Subject Keywords

Content

readme.md

Wetted-channel hysteresis

Code, model outputs, and interactive supplement accompanying Shifting runoff sources shape wetted channel length-discharge hysteresis by David N. Dralle, Dana A. Lapides, and W. Jesse Hahm.

Interactive supplement

Download wetted-channel-hysteresis.html and open it in a browser. It runs offline and provides parameter controls, CSV downloads, and video export. Video export depends on browser codec support.

Code and outputs

Extract wetted-channel-hysteresis-code-and-outputs.zip. It contains:

  • scripts/: Python model and figure-generation code.
  • outputs/distributed_reservoir_experiment/: source parameters, model time series, centroid diagnostics, and Figure 1 in PNG and PDF formats.
  • supplement/: standalone HTML, editable source, build script, and software tests.
  • requirements.txt and requirements.in: Python dependencies.

The CSV files and figures are also available separately on HydroShare.

Reproduce Figure 1

From the extracted archive root, using Python 3.11:

sh python3.11 -m venv .venv source .venv/bin/activate python -m pip install -r requirements.txt MPLBACKEND=Agg OPENBLAS_NUM_THREADS=1 python scripts/reproduce_figures.py

This regenerates the CSV files and figures in outputs/distributed_reservoir_experiment/ and copies the figure into manuscript/figs/. No manuscript input files are needed.

To rebuild the interactive HTML, use Node.js 22.13 or later:

sh cd supplement node scripts/build.mjs

Model and data

All inputs are synthetic. The conceptual channel is 1 km long and simulations cover days 0–30 after event onset. The paper figure uses 30 discrete sources; the interactive supplement defaults to 600 finite-area source cells and includes a paper-grid comparison. The centroid diagnostics compare analytical and numerical solutions using 600 discrete sources. These representations share instantaneous conservative routing and fixed wetting thresholds, but their trajectories need not match point for point.

File Contents
source_parameters.csv Source location, recharge delay and multiplier, and recession constant for each scenario
experiment_timeseries.csv Outlet discharge, wetted fraction, source and recharge centroids, and channel wetting capacity
centroid_diagnostics.csv Analytical and numerical centroid positions and velocities, input and recession contributions, and residuals

Column suffixes give units: _days is days, _km is kilometers, _mm_day is millimeters per day, and _per_day is inverse days. Centroid velocities and their contributions are in km/day. Discharge and recharge are depth-equivalent rates normalized by source area. Fractions are dimensionless. Distances are measured upstream from the outlet; downstream_fraction instead increases toward the outlet. Empty cells indicate undefined quantities, such as a flow centroid when discharge is zero.

Scenario names combine recharge progression (simultaneous, down-channel, or up-channel) with the location of slower recession (upstream or downstream). Figure rows A–F are, respectively: simultaneous/slow downstream; simultaneous/slow upstream; down-channel/slow downstream; up-channel/slow upstream; down-channel/slow upstream; up-channel/slow downstream.

Code and interactive HTML are licensed under MIT; model outputs, figures, and documentation are licensed under CC BY 4.0. See LICENSE.txt. Third-party components retain their original licenses, included in supplement/THIRD_PARTY_LICENSES.txt. Use HydroShare's How to Cite section for the resource citation.

Citation

Dralle, D. N., Lapides, D. A., & Hahm, W. J. (2026). Code, model outputs, and interactive supplement for Shifting runoff sources shape wetted channel length-discharge hysteresis [Data set and software]. HydroShare. https://doi.org/10.4211/hs.adbb73bdeac14273af3da9dc9c49ccd0

Credits

Funding Agencies

This resource was created using funding from the following sources:
Agency Name Award Title Award Number
Natural Sciences and Engineering Research Council of Canada Discovery Grant None
Simon Fraser University None None

How to Cite

Dralle, D. N., Lapides, D. A., Hahm, W. J. (2026). Code, model outputs, and interactive supplement for Shifting runoff sources shape wetted channel length-discharge hysteresis, HydroShare, https://doi.org/10.4211/hs.adbb73bdeac14273af3da9dc9c49ccd0

Code and interactive HTML are licensed under the MIT License. Model outputs, figures, and documentation are licensed under CC BY 4.0. Third-party components retain their original licenses.

Comments

There are currently no comments

New Comment

required