Skip to content


pyRive is the Python version of the RIVE code, embedded in pyNuts-Riverstrahler and BarMan models.

To access the code and be part of the development team, please contact the project manager through the RIVE website:

Once member of pyRive project, refer to this tutorial for code contribution: GitLab & Git for Rive


Copyright ©
CNRS (Centre National de la Recherche Scientifique), France
Sorbonne University, Paris France

pyRive created in 2013


  • Gilles BILLEN, CNRS - UMR7619 METIS
  • Vincent THIEU, Sorbonne University - UMR7619 METIS
  • Josette GARNIER, CNRS - UMR7619 METIS
  • Xingcheng YAN, Sorbonne University - UMR7619 METIS
  • Shuaitao WANG, Sorbonne University - UMR7619 METIS

pyRive code:

The RIVE model aims at representing the biogeochemical functioning of aquatic system, by simulating concentrations of oxygen and nutrients dissolved (NH4+, NO2-, NO3-, PO43-, SiO2) and particulate (PIP, BSi), suspended matter, dissolved and particulate organic carbon (3 classes of biodegradability), dissolved gases (CO2, N2O et CH4). Biological compartments are represented by 3 taxonomic classes of phytoplankton (diatoms, chlorophyceae, and cyanobacteria), 2 types of zooplankton (rotifers with short generation time and microcrustaceans with long generation time), 2 types of heterotrophic bacteria (small autochthonous and large allochthonous) as well as nitrifying bacteria. Faecal bacteria (free and attached) are also considered as state variables. The model also takes into account benthic variables (benthic organic matter, inorganic particulate phosphorus, benthic biogenic silica).

pyRive parameter values:

The value of the parameters related to the physiology of organisms and the kinetics of physical-chemical processes, have been determined, for most of them, through experiments or direct measurements. Their values have a great degree of genericity, at least for a given climatic regime, and do not require to be adjusted.
Two set of parameters are provided, for reservoir and river systems respectively. These set of parameters may slightely differ from their orginal publication values. Please always refer to the RIVE website (, where parameters of the RIVE kinetics are defined together with associated research papers.


This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which is available at, or the GNU General Public License, version 3 or any later version with the GNU Classpath Exception which is available at SPDX-License-Identifier: EPL-2.0 OR GPL-3.0-or-later WITH Classpath-exception-2.0