Skip to main content

Crate hydro_swat

Crate hydro_swat 

Source
Expand description

SWAT+ LTE 简化驱动(水文核心)——忠实移植自 swatplus/src/hru_lte_control.f90。

Clean-room 从 USDA-ARS SWAT+ (github.com/swat-model/swatplus, 公共领域) 算法移植。 单文件日驱动:SCS-CN 两阶段(日 CN 从土壤湿度→Q)+ 雪 + Hargreaves/PT PET + AET

  • 侧向流 + 暗管 + 渗漏 + 指数地下水退水。单位:mm / day(与 SWAT+ 一致)。

交叉验证:tests/swat_crosscheck.rs(待加)vs SWAT+ on Ames_sub1(12 HRU, 46 年)。

§English summary

SWAT+ LTE (Long-Term Evaluation) simplified driver — the daily hydrology core, faithful port of the algorithm in swatplus/src/hru_lte_control.f90. Single-file daily driver: two-stage SCS-CN (daily curve number updated from soil moisture, then runoff), snow accumulation/melt, Hargreaves or Priestley–Taylor potential ET, actual ET, lateral flow, tile drainage, percolation, and exponential groundwater recession. Units are mm/day to match SWAT+.

Clean-room statement: this Rust implementation is a clean-room port of USDA-ARS SWAT+ (swatplus), which is public domain (US government work). The algorithm is not copyrighted; the Fortran source was used only as a behaviour oracle for cross-verification. No Fortran source code is reproduced here.

For the full per-layer HRU module set (canopy interception, multi-layer percolation, plant phenology, soil temperature, Penman–Monteith PET, etc.) see the swat_hru submodule — a clean-room port of hru_control.f90’s hydrology subset, bit-exact against SWAT+ on the Ames_sub1 dataset (12 HRU, 46 years).

Cross-verification: tests/swat_crosscheck.rs against SWAT+ on Ames_sub1 (available from TAMU SWAT+ Example_datasets). Implements hydro_core::HydroModel so the model can be orchestrated by hydro-platform.

Modules§

swat_hru
SWAT+ 全路径 HRU 水文核心模块(clean-room 从 swatplus Fortran 移植)。

Structs§

DailyOutput
Daily water-balance output (one row per simulated day), corresponding to the SWAT+ hltwb_d output record from hru_lte_control.f90. All water quantities are in mm unless noted.
DailyWeather
Daily weather forcing for the SWAT+ LTE driver (matches the per-day fields read from SWAT+ weather files). All radiation quantities are in MJ/m²/day, matching et_pot.f90 conventions.
SwatModel
hydro_core::HydroModel wrapper around SwatParams that steps the SWAT+ LTE daily driver one day at a time and exposes the channel outflow in m³/s.
SwatOutput
Batch output of run_swat_lte_full: a vector of daily records, one per input weather row.
SwatParams
SWAT+ LTE parameters — the lumped daily driver configuration consumed by run_swat_lte_full and SwatModel.

Enums§

PetMethod
Potential evapotranspiration method selector for the SWAT+ LTE driver.

Functions§

run_swat_lte_full
Run the full SWAT+ LTE daily driver (faithful to hru_lte_control.f90’s daily loop).