Skip to main content

Crate hydro_xinanjiang

Crate hydro_xinanjiang 

Source
Expand description

新安江模型(三层蒸发 + 蓄满产流 + 三水源 + 单位线汇流 + 线性水库退水)。

算法对齐赵人俊《水文预报》标准 + 开源参考 OuyangWenyu/hydromodel xaj.py。 实现 hydro_core::HydroModel trait,可被 hydro-platform 统一编排。

  • 产流 run_xinanjiang_step(三层 ET + 蓄满产流 + 张力水更新 + 三水源)逐行对齐 xaj.py;交叉验证在 tests/xaj_crosscheck.rs(9 变量 ×3 场景 NSE>0.999 + relBias<0.1%, 数据 tests/xaj_data/*,由 validation/xaj/gen_reference.py 生成)。
  • 汇流 地表 rs 经单位线 UH 卷积(convolve_uh)+ 壤中流/地下水 ci/cg 线性水库
    • cs 河网平滑。单位线提供地表延迟(此前为“直接入流“)。

说明:平台(H8)只供面平均 forcing,故本 trait 在单出口约束下提供单位线汇流; 完整分布式多子流域 + 马斯京根河道拓扑演算需逐子流域 forcing + 河网拓扑,留作后续。

§English summary

Distributed Xinanjiang rainfall–runoff model (Zhao Renjun, Hydrological Forecasting) for basins where saturation-excess runoff dominates. Each step runs three-layer evapotranspiration, saturation-excess production over a variable-capacity curve, three-source separation (surface / interflow / groundwater) on a free-water store, and linear-reservoir routing with a unit-hydrograph lag on surface runoff.

  • Production run_xinanjiang_step follows the reference OuyangWenyu/hydromodel xaj.py line by line; cross-verified in tests/xaj_crosscheck.rs (9 variables × 3 scenarios, NSE > 0.999 and relative bias < 0.1 %; data under tests/xaj_data/*, generated by validation/xaj/gen_reference.py).
  • Routing routes surface source rs through a unit hydrograph (convolve_uh); interflow and groundwater pass through ci / cg linear reservoirs and the total is smoothed by the cs network store.

Implements hydro_core::HydroModel so the model can be orchestrated by hydro-platform. The platform supplies spatially averaged forcing, so the trait exposes single-outlet unit-hydrograph routing; a fully distributed multi-subbasin build with Muskingham channel topology is left for later.

Structs§

BasinState
Continuous hydrological state carried across time steps. All fields are basin-wide averages.
RunoffSource
One-step runoff output, expressed as basin-average depth (mm/Δt) at the channel inlet.
XinanjiangModel
Xinanjiang model instance: parameters + production state + routing reservoirs + surface-runoff (rs) history for unit-hydrograph convolution.
XinanjiangParams
Xinanjiang model parameters (16 params + unit hydrograph + basin area).

Functions§

convolve_uh
Unit-hydrograph convolution at the latest step.
run_xinanjiang_step
One-step Xinanjiang production: three-layer ET + saturation-excess runoff