timflow.transient.linesink.DitchString
======================================

.. toctree::
   :hidden:

   /api/timflow/transient/linesink/DitchString.initialize
   /api/timflow/transient/linesink/DitchString.potinf
   /api/timflow/transient/linesink/DitchString.disvecinf
   /api/timflow/transient/linesink/DitchString.headinside
   /api/timflow/transient/linesink/DitchString.plot
   /api/timflow/transient/linesink/DitchString.run_after_solve
   /api/timflow/transient/linesink/DitchString.discharge_list
   /api/timflow/transient/linesink/DitchString.potential
   /api/timflow/transient/linesink/DitchString.unitpotential
   /api/timflow/transient/linesink/DitchString.unitpotentialone
   /api/timflow/transient/linesink/DitchString.disvec
   /api/timflow/transient/linesink/DitchString.unitdisvec
   /api/timflow/transient/linesink/DitchString.potinflayers
   /api/timflow/transient/linesink/DitchString.potentiallayers
   /api/timflow/transient/linesink/DitchString.unitpotentiallayers
   /api/timflow/transient/linesink/DitchString.disvecinflayers
   /api/timflow/transient/linesink/DitchString.disveclayers
   /api/timflow/transient/linesink/DitchString.unitdisveclayers
   /api/timflow/transient/linesink/DitchString.discharge
   /api/timflow/transient/linesink/DitchString.dischargeold
   /api/timflow/transient/linesink/DitchString.equation

.. py:class:: timflow.transient.linesink.DitchString(model, xy=[(-1, 0), (1, 0)], tsandQ=[(0, 1)], res=0, wh='H', layers=0, Astorage=None, label=None)

   Bases: :py:obj:`LineSinkStringBase`, :py:obj:`timflow.transient.equation.MscreenDitchEquation`


   
   Create ditch consisting of a string of line-sink.

   The total discharge for the string is specified and divided over the line-sinks such
   that the head at the center inside each line-sink is equal. A width and resistance
   may optionally be specified.

   Inflow per unit length of line-sink is computed as:

   .. math::
       \sigma = w(h_{aq} - h_{ls})/c

   where :math:`c` is the resistance of the bottom of the line-sink,
   :math:`w` is the width over which water enters the line-sink,
   :math:`h_{aq}` is the head in the aquifer at the center of the line-sink,
   :math:`h_{ls}` is the specified head inside the line-sink
   Note that all that matters is the conductance term :math:`w/c` but
   both are specified separately

   :param model: Model to which the element is added
   :type model: Model object
   :param xy: list or array of (x,y) pairs of coordinates of end-points of
              line-sinks in string
   :type xy: array or list
   :param tsandQ: if list or 2D array: pairs of time and discharge after that time
   :type tsandQ: list or 2D array of (time, discharge) values
   :param res: resistance of line-sink
   :type res: scalar (default is 0)
   :param wh: distance over which water enters line-sink
              if 'H': (default) distance is equal to the thickness of the aquifer
              layer (when flow comes mainly from one side)
              if '2H': distance is twice the thickness of the aquifer layer (when
              flow comes from both sides)
              if scalar: the width of the stream that partially penetrates the
              aquifer layer
   :type wh: scalar or str
   :param layers: layer(s) in which element is placed
                  if scalar: element is placed in this layer
                  if list or array: element is placed in all these layers
   :type layers: scalar, list or array
   :param label: label of element
   :type label: str or None















   ..
       !! processed by numpydoc !!
Methods
-------

.. autoapisummary::

   timflow.transient.linesink.DitchString.initialize
   timflow.transient.linesink.DitchString.potinf
   timflow.transient.linesink.DitchString.disvecinf
   timflow.transient.linesink.DitchString.headinside
   timflow.transient.linesink.DitchString.plot
   timflow.transient.linesink.DitchString.run_after_solve
   timflow.transient.linesink.DitchString.discharge_list
   timflow.transient.linesink.DitchString.potential
   timflow.transient.linesink.DitchString.unitpotential
   timflow.transient.linesink.DitchString.unitpotentialone
   timflow.transient.linesink.DitchString.disvec
   timflow.transient.linesink.DitchString.unitdisvec
   timflow.transient.linesink.DitchString.potinflayers
   timflow.transient.linesink.DitchString.potentiallayers
   timflow.transient.linesink.DitchString.unitpotentiallayers
   timflow.transient.linesink.DitchString.disvecinflayers
   timflow.transient.linesink.DitchString.disveclayers
   timflow.transient.linesink.DitchString.unitdisveclayers
   timflow.transient.linesink.DitchString.discharge
   timflow.transient.linesink.DitchString.dischargeold
   timflow.transient.linesink.DitchString.equation