class RechargeModel(prec, evap, rfunc=None, name='recharge', recharge=None, temp=None, cutoff=0.999, settings=('prec', 'evap', 'evap'), metadata=(None, None, None))[source]#

Stressmodel simulating the effect of groundwater recharge on the groundwater head.

  • prec (pandas.Series or pastas.timeseries.TimeSeries) – pandas.Series or pastas.timeseries object containing the precipitation series.

  • evap (pandas.Series or pastas.timeseries.TimeSeries) – pandas.Series or pastas.timeseries object containing the potential evaporation series.

  • rfunc (pastas.rfunc instance (class is deprecated), optional) – Response function used in the convolution with the stress. Default is Exponential.

  • name (str, optional) – Name of the stress. Default is “recharge”.

  • recharge (pastas.recharge instance, optional) – Instance of a recharge model. Options are: Linear, FlexModel and Berendrecht. These can be accessed through ps.rch. If no recharge model is provided, ps.rch.Linear() is used.

  • temp (pandas.Series or pastas.timeseries.TimeSeries, optional) – pandas.Series or pastas.TimeSeries object containing the temperature series. It depends on the recharge model is this argument is required or not.

  • cutoff (float, optional) – float between 0 and 1 to determine how long the response is (default) is 99.9% of the actual response time). Used to reduce computation times.

  • settings (list of dicts or str, optional) – The settings of the precipitation and evaporation time series, in this order. This can be a string referring to a predefined settings dict, or a dict with the settings to apply. Refer to the docstring of pastas.Timeseries for further information. Default is ( “prec”, “evap”).

  • metadata (tuple of dicts or list of dicts, optional) – dictionary containing metadata about the stress. This is passed onto the TimeSeries object.


This stress model computes the contribution of precipitation and potential evaporation in two steps. In the first step a recharge flux is computed by a model determined by the input argument recharge. In the second step this recharge flux is convoluted with a response function to obtain the contribution of recharge to the groundwater levels.


>>> sm = ps.RechargeModel(rain, evap, rfunc=ps.Exponential(),
>>>                       recharge=ps.rch.FlexModel(), name="rch")
>>> ml.add_stressmodel(sm)


We recommend not to store a RechargeModel is a variable named rm. This name is already reserved in IPython to remove files and will cause problems later.






Method to dump all stresses in the stresses list.


Determine in how many timeseries the contribution can be split.


Method to obtain the recharge stress calculated by the model.


Method to obtain the water balance components.


Internal method to set the initial parameters.


Method to simulate the contribution of recharge to the head.


Method to export the StressModel object.


Method to update the settings of the individual TimeSeries.