.. include:: ../notations/notations.rst

=======
Pumping
=======

To activate pumping, the user needs to provide pumping data as inputs to the
model. It is recommended to provide pumping data in |m3/s| but other units are
possible as long as the user provides an adapted pumping coefficient.

A Nash model with two linear reservoirs is used to introduce a time delay in the
pumping time series. These two reservoirs are characterized by their own
half-life time constant.

.. _pumping_parameters:

Physical parameters
===================

River pumping coefficient
-------------------------

.. code-block:: toml

    [watershed.1]
    pumping.river.coefficient = { value = 1.0, opti = false }

River pumping halflife time rise
--------------------------------

.. code-block:: toml

    [watershed.1]
    pumping.river.halflife_rise = { value = 0.5, lower = 0.05, upper = 10.0, opti = false, sameas = 0 }

River pumping halflife time fall
--------------------------------

.. code-block:: toml

    [watershed.1]
    pumping.river.halflife_fall = { value = 2.0, lower = 0.05, upper = 15.0, opti = false, sameas = 0 }


Groundwater pumping coefficient
-------------------------------

.. code-block:: toml

    [watershed.1]
    pumping.groundwater.coefficient = { value = 1.0, opti = false }

Groundwater pumping halflife_rise
---------------------------------

.. code-block:: toml

    [watershed.1]
    pumping.groundwater.halflife_rise = { value = 0.5, lower = 0.05, upper = 10.0, opti = false, sameas = 0 }


Groundwater pumping halflife_fall
---------------------------------

.. code-block:: toml

    [watershed.1]
    pumping.groundwater.halflife_fall = { value = 2.0, lower = 0.05, upper = 15.0, opti = false, sameas = 0 }