HydroPol2D - HydroPol2D v1.17.0

HydroPol2D v1.17.0

Overview

HydroPol2D v1.17.0 consolidates the current MATLAB model, its input
workflows, and its reproducible validation suite in one self-contained
repository.

Model and Inputs

• Retains the bundled GPLv3 TopoToolbox v2.4-derived runtime, so users do not
  need to configure an external TopoToolbox installation.
• Consolidates the current layered-soil, asynchronous groundwater, snow,
  evapotranspiration, routing, water-quality, calibration, and particle-filter
  workflows.
• Keeps spreadsheet and bypass-script inputs aligned with the active model
  configuration.

Validation

• Standardizes validation paths, case identifiers, registry entries, and
  release commands under Validation/.
• Corrects cumulative-infiltration storage and map export, groundwater
  diagnostic drainage area, full-momentum hydrostatic reconstruction, and
  water-quality washoff time-step and outlet-mass handling.
• Provides one release command that runs 23 checks for interception, snow,
  infiltration, evapotranspiration, groundwater, hydrodynamics, routing,
  boundaries, reservoirs, rainfall, water quality, human risk, and the
  Neal (2012) channel extension.

Run the suite from the repository root:

python3 Validation/scripts/run_validation_release.py \
  --matlab /Applications/MATLAB_R2025b.app/bin/matlab
python3 Validation/scripts/audit_validation_registry.py

The local-inertial and diffusive Ritter comparisons are retained as
method-limited diagnostics because those approximations do not represent a
full-momentum dry-bed dam break. The Neal (2012) staged-overbank benchmark
documents its late-recession limitation.

MATLAB Requirements

HydroPol2D requires Mapping Toolbox and Image Processing Toolbox. Optimization
Toolbox is required only when DEM smoothing is enabled.

Natural Resources - Water Supply and Quality - MATLAB
Published by marcusnobrega-eng about 1 month ago

HydroPol2D - HydroPol2D v1.16.0

HydroPol2D v1.16.0

Bundled Terrain Runtime

• Bundles the required TopoToolbox v2.4-based source subset under
  third_party/topotoolbox_lite/.
• Removes the user-facing external TopoToolbox setting from bypass
  configuration and spreadsheet inputs.
• Registers HydroPol2D functions and the bundled runtime through
  hydropol2d_add_runtime_paths.
• Keeps the existing GRIDobj, FLOWobj, and STREAMobj interfaces so
  terrain preprocessing results remain consistent with the prior workflow.
• Retains three documented, unmodified later upstream methods needed for
  current MATLAB smoothing compatibility; see
  third_party/topotoolbox_lite/UPSTREAM.md.

Requirements and Licensing

• Mapping Toolbox and Image Processing Toolbox remain required.
• Optimization Toolbox is required only when DEM smoothing is enabled.
• Parallel Computing Toolbox remains optional for GPU execution.
• HydroPol2D and the bundled TopoToolbox source are distributed under GPLv3;
  see LICENSE and third_party/NOTICE.md.

Upgrade Notes

Remove any previous addpath commands for an external TopoToolbox copy. Run
HydroPol2D_V115.m from the repository root, or use a supported case runner.

Natural Resources - Water Supply and Quality - MATLAB
Published by marcusnobrega-eng about 1 month ago