This method paper explains the i-Tree Cool River model algorithms for simulating the response of river water temperature to urban greening. The model captures the warming and cooling impacts of urban development and restoration through a water and energy budget. The water budget includes river inflows from urban storm sewers and reservoirs, and the associated water temperatures. The energy budget adjusts radiation fluxes due to riparian shading and evapotranspiration, and propagates temperature downstream. Restorative cooling of the river can be simulated through algorithms for cool groundwater, either as direct inflows or by river water replacement called hyporheic exchange. Novel features in the model include diurnal variation in riparian shading, use of the Army Corps of Engineers HEC-RAS model predicted river depths and velocities, and periodic boundary conditions to rapidly extend restoration scenarios.•Freely available code in C++ for Visual Studio, with a detailed manual and sample inputs and outputs at http://www.itreetools.org/research_suite/coolriver.•Useful for simulating river warming or cooling due to urban development or greening.•Well documented source code compatible with requirements of other modeling groups.
Keywords: Aquatic thermal habitat; Energy balance; Mechanistic model; Thermal pollution.
© 2020 The Author(s). Published by Elsevier B.V.