v2.0.0 — hydroRaVENS

This release marks a complete overhaul of the package, previously distributed as a single-file script called bucketHydrology. The model is now a proper Python package named hydroravens, installable via pip, with a CSDMS-compliant BMI interface and a command-line entry point.

Breaking changes

• Package renamed from bucketHydrology to hydroravens; all existing import and calling code must be updated
• Model configuration is now driven entirely by a YAML file; the old script-based interface is gone

New features

• CSDMS Basic Model Interface: initialize(), update(), run(), finalize()
• Command-line interface: hydroravens -y config.yml
• Snowpack model with positive-degree-day melt, fully integrated with mass balance
• Evapotranspiration: read from data file or computed via the Thorntwaite–Chang (2019) method
• Water-year ET scaling to enforce P − Q − ET = 0 mass balance
• Nash–Sutcliffe Efficiency (computeNSE())
• Configurable spin-up cycles
• Subsurface storage tracked as model output
• CITATION.cff added

Infrastructure

• pip-installable via setup.py
• Version number introduced (2.0.0)
• Cannon River included as reference test case and example configuration

Note: version infrastructure and tag created 2026-05-04 and backdated to 2023-11-21 to match the date of the substantive work.