hydrocraft-raven

Use the ensemble comparison tool with a list of templates such as gr4j, hbv_ec, hmets, hymod, and sac_sma. All models run on identical forcing and HRU definitions, then are ranked by NSE and KGE computed over the calibration window.

Use the forcing conversion tool, which aggregates 3-hourly precipitation to daily mm, converts Kelvin to Celsius, and rescales radiation and pressure to Raven's expected units. Raven performs no unit conversion itself, so all conversions must happen in this tool.

Use HBV-EC, HMETS, or UBC, which include snow processes. GR4J, HYMOD, and basic SAC-SMA have no snow routines, so winter precipitation becomes rain and produces wrong seasonal patterns in cold basins.

Raven silently fills missing forcing variables with zeros, so an absent PRECIP block in the .rvt file yields zero precipitation and zero discharge. Verify PRECIP is present and check the ForcingFunctions.csv output for internally generated approximations.

Hydrographs.csv is period-ending, so the row stamped with a date holds the preceding timestep's average, while observation input is period-starting. Use the provided load_discharge_series reader, which applies the calendar-date correction, instead of joining on raw date labels.

It does not cover data assimilation, reservoir operations, water demand management, tracer transport, glacier processes, or MODFLOW groundwater coupling, because those require upstream data infrastructure not yet available. The generic template tool also has a known parameter-placement issue worked around with hand-crafted templates.