Skip to main content

Crate hydro_apicont

Crate hydro_apicont 

Source
Expand description

API-CONT:前期降水指数连续基线模型(廉价,3 参数)。

单线性蓄水库 + 蒸发 + 线性水库汇流。蓄水量 sm 经指数退水 (1−k)·sm 排出为径流 (即前期降水的指数记忆,API 的本质);再经 cs 线性水库演算到出口。 严格水量平衡:rain = ET + drain + Δsm。适合作为多模型对比中最廉价的连续基线。

§English

hydro-apicont is API-CONT, a cheap 3-parameter continuous baseline rainfall–runoff model built around the antecedent precipitation index (API). A single linear storage sm (mm) is filled by rain, drained by ET, and exponentially depleted to runoff via (1 − k) · sm each step — the classic exponential memory that gives API models their receding signature. A second linear-reservoir routing store with recession cs then advects that drained water to the basin outlet as discharge (m³/s).

The model enforces a strict mass balance rain = ET + drain + Δsm every step (see the no_mass_creation_constant_rain test). With only k, cs, and area_km2 to set, it is intended as the cheapest member of the multi-model ensemble orchestrated by hydro-platform, useful as a baseline against which the structurally richer Xinanjiang / TOPMODEL / SWAT+ LTE models can be scored.

§Mass balance

For each step of length dt_h (hours):

  1. Fill: sm ← sm + max(P, 0)
  2. ET: ea = min(PET, sm), sm ← sm − ea
  3. Drain: drain = (1 − k) · sm, sm ← sm − drain (← API exponential memory)
  4. Route: Q ← cs · Q + (1 − cs) · mm_to_m3s(drain, area_km2, dt_h)

where mm_to_m3s(mm, area_km2, dt_h) = mm · area_km2 · 1000 / (dt_h · 3600). Summed over a step, P = ea + drain + Δsm exactly — no mass is created.

Structs§

ApicontModel
API-CONT continuous baseline model — single linear antecedent store + linear-reservoir routing.
ApicontParams
API-CONT model parameters (3 scalars).