i-Tree Cool River

(If you have questions about this tool, please do not contact i-Tree support. Instead, please reach out to: Dr. Ted Endreny)


  • The i-Tree Cool River Model mechanistically simulates temperature in rivers.
  • Storm event simulations represent the warming effect of runoff from impervious areas.
  • Riparian shading diminishes warming and subsurface inflows provide a cooling effect.
  • C++ code uses Gaussian elimination linear interpolation for matrix operations.


The i-Tree Cool River Model is a one-dimensional river temperature model in steady and unsteady modes in varying time and space using a combination of temperature change driven by the advection, dispersion, energy flux, and mixing process. The model applies upstream boundary condition, diurnal temperature, river geometric data, discharge data, and meteorological data to predict river temperature using a finite difference method.

The i-Tree Cool River Model is designed to allow for flexible shading factor algorithms, unsteady flow of storm sewers, as well as other energy flux and mixing processes. The i-Tree Cool River model package contains the C++ routines and an executable file for running the code, which can be downloaded below. The model executable is called at the command line along with an extensible markup language (XML) file, which includes the required initial information. The i-Tree Cool River Model C++ algorithms can be edited and recompiled with Visual Studio 2017 Community Edition, which is freeware. The outputs of running the model include the predicted river temperature, the volumes and temperatures of mixing processes, and the magnitude of energy fluxes. The program is written primarily for x64 platforms, and we also provided a Win32 (x86 platform) executable. Users who want to compile the source code for the x86 platform should contact us for further instructions.







Scientific paper introducing i-Tree Cool River model: Abdi and Endreny, 2019