The default behavior for adding and solving with noisemodels has changed from Pastas 1.5. Find more information here

Non-linear recharge models#

R.A. Collenteur, University of Graz

This notebook explains the use of the RechargeModel stress model to simulate the combined effect of precipitation and potential evaporation on the groundwater levels. For the computation of the groundwater recharge, four recharge models are currently available:

The first model is a simple linear function of precipitation and potential evaporation while the latter two are simulate a non-linear response of recharge to precipitation using a soil-water balance concepts. Detailed descriptions of these models can be found in articles listed in the References at the end of this notebook.

import pandas as pd
import pastas as ps
import matplotlib.pyplot as plt

Python version: 3.11.6
NumPy version: 1.26.4
Pandas version: 2.2.2
SciPy version: 1.13.0
Matplotlib version: 3.8.4
Numba version: 0.59.1
LMfit version: 1.3.1
Latexify version: Not Installed
Pastas version: 1.5.0

Read Input data#

Input data handling is similar to other stressmodels. The only thing that is necessary to check is that the precipitation and evaporation are provided in mm/day. This is necessary because the parameters for the non-linear recharge models are defined in mm for the length unit and days for the time unit. It is possible to use other units, but this would require manually setting the initial values and parameter boundaries for the recharge models.

head = pd.read_csv(
    "data/B32C0639001.csv", parse_dates=["date"], index_col="date"

# Make this millimeters per day
evap = pd.read_csv("data/evap_260.csv", index_col=0, parse_dates=[0]).squeeze()
rain = pd.read_csv("data/rain_260.csv", index_col=0, parse_dates=[0]).squeeze()

    [evap, rain],
    figsize=(10, 6),
    labels=["Head [m]", "Evap [mm/d]", "Rain [mm/d]"],

Make a basic model#

The normal workflow may be used to create and calibrate the model.

  1. Create a Pastas Model instance

  2. Choose a recharge model. All recharge models can be accessed through the recharge subpackage (ps.rch).

  3. Create a RechargeModel object and add it to the model

  4. Solve and visualize the model

ml = ps.Model(head)

# Select a recharge model
rch = ps.rch.FlexModel(gw_uptake=True)
# rch = ps.rch.Berendrecht()
# rch = ps.rch.Linear()
# rch = ps.rch.Peterson()

rm = ps.RechargeModel(rain, evap, recharge=rch, rfunc=ps.Gamma(), name="rch")

ml.solve(tmin="1990", report="basic")
ml.plots.results(figsize=(10, 6));
Fit report head                   Fit Statistics
nfev    45                     EVP         90.32
nobs    351                    R2           0.90
noise   True                   RMSE         0.06
tmin    1990-01-01 00:00:00    AICc     -2071.16
tmax    2005-10-14 00:00:00    BIC      -2036.94
freq    D                      Obj          0.46
warmup  3650 days 00:00:00     ___              
solver  LeastSquares           Interp.        No

Parameters (9 optimized)
                optimal     initial   vary
rch_A          0.408502    0.438424   True
rch_n          0.650442    1.000000   True
rch_a        328.566853   10.000000   True
rch_srmax     54.401910  250.000000   True
rch_lp         0.250000    0.250000  False
rch_ks        19.672638  100.000000   True
rch_gamma      4.064216    2.000000   True
rch_kv         1.000000    1.000000  False
rch_simax      2.000000    2.000000  False
rch_gf         0.236322    1.000000   True
constant_d     0.879641    1.359779   True
noise_alpha   31.275810   15.000000   True

Analyze the estimated recharge flux#

After the parameter estimation we can take a look at the recharge flux computed by the model. The flux is easy to obtain using the get_stress method of the model object, which automatically provides the optimal parameter values that were just estimated. After this, we can for example look at the yearly recharge flux estimated by the Pastas model.

recharge = ml.get_stress("rch").resample("A").sum()
ax =, 3))
plt.ylabel("Recharge [mm/year]");

A few things to keep in mind:#

Below are a few things to keep in mind while using the (non-linear) recharge models.

  • The use of an appropriate warmup period is necessary, so make sure the precipitation and evaporation are available some time (e.g., one year) before the calibration period.

  • Make sure that the units of the precipitation fluxes are in mm/day and that the DatetimeIndex matches exactly.

  • It may be possible to fix or vary certain parameters, dependent on the problem. Obtaining better initial parameters may be possible by solving without a noise model first and then solve it again using a noise model.

  • For relatively shallow groundwater levels (e.g., < 10 meters), it may be better to use the Exponential response function as the the non-linear models already cause a delayed response.


Data Sources#

In this notebook we analysed a head time series near the town of De Bilt in the Netherlands. Data is obtained from the following resources:

  • The heads (B32C0639001.csv) are downloaded from

  • The precipitation and evapotranspiration (rain_260.csv and evap_260.csv) are downloaded from