Wells

Two main classes are in this module: Well and WellResponse objects. Well objects contain all the information about a pumping well and the aquifer and stream-related properties necessary to calculate responses. Those responses are either drawdown or depletion. One or more WellResponse objects is constructed for each Well, with properties and methods necessary to calculate and keep track of specific responses.

The AnalysisProject object is one way to combine multiple wells and responses into a consolidated workflow. Examples show lower-level options to put together workflows.

class pycap.wells.Well(well_status='pending', T=-9999, S=-99999, Q=-99999, depletion_years=5, theis_dd_days=-9999, depl_pump_time=-9999, stream_dist=None, drawdown_dist=None, stream_apportionment=None, depl_method='walton_depletion', drawdown_method='theis_drawdown', streambed_conductance=None, Bprime=None, Bdouble=None, sigma=None, width=None, T2=None, S2=None, streambed_thick=None, streambed_K=None, aquitard_thick=None, aquitard_K=None, x=None, y=None)[source]

Bases: object

Object to evaluate a pending (or existing, or a couple other possibilities) well with all relevant impacts. Preprocessing makes unit conversions and calculates distances as needed

Parameters

T: float: Aquifer Transmissivity [L**2/T]
S: float: Aquifer Storage [unitless]
Q: pandas series: Pumping rate changes and times [L**3/T]
depletion_years: int, optional: Number of years over which to calculate depletion. Defaults to 4.
theis_dd_days: int: Number of days at which drawdown is calculated. Defaults to -9999.
depl_pump_time: integer, optional: Length of time per year that pumping should be simulated for depletion calculations [T]. Not used if pumping time series is used. Defaults to -99999.
stream_apportionment: dict of floats: Dictionary with stream responses and fraction of depletion attributed to each. Defaults to None.
drawdown_dist: float: Distance between well and drawdown calculation location. [L]
stream_apportionment: dict of floats: Dictionary with stream responses and fraction of depletion attributed to each. Defaults to None.
depl_method: string, optional: Method to be used for depletion calculations. Defaults to ‘glover_depletion’.
drawdown_method: string, optional: Method to be used for drawdown calculations. Defaults to ‘theis_drawdown’. Only ‘theis_drawdown’ is available right now in the Well() class, if Hunt (1999) or Dudley Ward and Lough (2014) are desired, the function must be called directly
streambed_conductance: float: Streambed conductance for the hunt_99_depletion depletion method [L/T]. Defaults to None
Additional Parameters Used by Hunt and Dudley Ward/Lough Solutions
———————————————————–
Bprime: float: saturated thickness of semiconfining layer containing stream, [L]
Bdouble: float: distance from bottom of stream to bottom of semiconfining layer, [L] (aquitard thickness beneath the stream)
aquitard_K: float: hydraulic conductivity of semiconfining layer [L/T]
sigma: float: porosity of semiconfining layer
width: float: stream width [T]
x: float: x-coordinate of drawdown location (with origin being x=0 at stream location) [L]
y: float: y-coordinate of drawdown location (with origin being y=0 at pumping well location) [L]
Additional Parameters Used by Dudley Ward/Lough Solutions
————————————————–
T2: float: Transmissivity of deeper system
S2: float: Storativity of
streambed_thick: float: thickness of streambed
streambed_K: float: hydraulic conductivity of streambed, [L/T]
aquitard_thick: float: thickness of intervening leaky aquitard, [L]

property depletion

property drawdown

property max_depletion

class pycap.wells.WellResponse(name, response_type, T, S, dist, Q, stream_apportionment=None, dd_method='theis_drawdown', depl_method='glover_depletion', theis_time=-9999, depl_pump_time=-99999, streambed_conductance=None, Bprime=None, Bdouble=None, sigma=None, width=None, T2=None, S2=None, streambed_thick=None, streambed_K=None, aquitard_thick=None, aquitard_K=None, x=None, y=None)[source]

Bases: object

Class to facilitate depletion or drawdown calculations

Objects from this class will have the required information needed to call any of the analysis methods in the package. The intent is that users will not have to access analytical solutions directly, but can set up a WellResponse object. The generation of WellResponse objects is generally done through an AnalysisProject object.

Class to calculate a single response for a single pumping well.

Parameters

name: string: pumping well name
response_type: string: reserved for future implementation
T: float: Aquifer Transmissivity [L**2/T]
S: float: Aquifer Storage [unitless]
dist: float: Distance between well and response [L]
Q: pandas series: Pumping rate changes and times [L**3/T]
stream_apportionment: dict of floats: Dictionary with stream responses and fraction of depletion attributed to each. Defaults to None.
dd_method: string, optional: Method to be used for drawdown calculations. Defaults to ‘theis_drawdown’.
depl_method: string, optional: Method to be used for depletion calculations. Defaults to ‘glover_depletion’.
theis_time: integer, optional: Time at which drawdown calculation should be made [T]. Defaults to -9999.
depl_pump_time: integer, optional: Length of time per year that pumping should be simulated for depletion calculations [T]. Not used if pumping time series is used. Defaults to -99999.
streambed_conductance: float: Streambed conductance for the hunt_99_depletion depletion method [L/T]. Defaults to None
Additional Parameters Used by Hunt and Dudley Ward/Lough Solutions
———————————————————–
Bprime: float: saturated thickness of semiconfining layer containing stream, [L]
Bdouble: float: distance from bottom of stream to bottom of semiconfining layer, [L] (aquitard thickness beneath the stream)
aquitard_K: float: hydraulic conductivity of semiconfining layer [L/T]
sigma: float: porosity of semiconfining layer
width: float: stream width [T]
x: float: x-coordinate of drawdown location (with origin being x=0 at stream location) [L]
y: float: y-coordinate of drawdown location (with origin being y=0 at pumping well location) [L]
Additional Parameters Used by Dudley Ward/Lough Solutions
————————————————–
T2: float: Transmissivity of deeper system
S2: float: Storativity of
streambed_thick: float: thickness of streambed
streambed_K: float: hydraulic conductivity of streambed, [L/T]
aquitard_thick: float: thickness of intervening leaky aquitard, [L]

property depletion

property drawdown