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_stepfollows the referenceOuyangWenyu/hydromodel xaj.pyline by line; cross-verified intests/xaj_crosscheck.rs(9 variables × 3 scenarios, NSE > 0.999 and relative bias < 0.1 %; data undertests/xaj_data/*, generated byvalidation/xaj/gen_reference.py). - Routing routes surface source
rsthrough a unit hydrograph (convolve_uh); interflow and groundwater pass throughci/cglinear reservoirs and the total is smoothed by thecsnetwork 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§
- Basin
State - Continuous hydrological state carried across time steps. All fields are basin-wide averages.
- Runoff
Source - One-step runoff output, expressed as basin-average depth (mm/Δt) at the channel inlet.
- Xinanjiang
Model - Xinanjiang model instance: parameters + production state + routing
reservoirs + surface-runoff (
rs) history for unit-hydrograph convolution. - Xinanjiang
Params - 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