Skip to content

unifhy-org/unifhycontrib-gr4

Repository files navigation

A unifhy-compliant version of the rainfall-runoff model GR4

PyPI Version DOI Tests Status

The GR4 ("Génie Rural à 4 paramètres" [in French]) model is a bucket-type rainfall-runoff model featuring four parameters.

It is typically used as a daily model, i.e. GR4J model (Perrin et al., 2003). It can also be used at other temporal resolutions, e.g. hourly in GR4H model, provided an adjustment in its time-dependent parameter and constant values is performed (Ficchì et al., 2016). The model has recently been expressed in a state-space formulation (Santos et al., 2018).

This version of the GR4 model is based on its explicit state-space formulation and its recommended temporal resolutions are daily or hourly. With either of these resolutions, time-dependent parameters x2, x3, x4, and constant nu are expected for the daily case and they are adjusted accordingly if temporal resolution is not daily.

The surface layer component of the GR4 model comprises the interception scheme.

The subsurface component of the GR4 model comprises the runoff generation and the runoff routing using the Nash cascade.

The openwater component of the GR4 model comprises the runoff routing using the routing store, and the inter-catchment groundwater exchange.

contributors:

Thibault Hallouin [1,2]

affiliations:
  1. Department of Meteorology, University of Reading
  2. National Centre for Atmospheric Science
licence:

GPL-2.0

codebase:

https://github.com/unifhy-org/unifhycontrib-gr4

How to install

This package is available on PyPI, so you can simply run:

pip install unifhycontrib-gr4