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', drawdown_method='theis', 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)

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

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’.

drawdown_method: string, optional

Method to be used for drawdown calculations. Defaults to ‘Theis’.

streambed_conductance: float

Streambed conductance for the Hunt99 depletion method [L/T]. Defaults to None

property depletion

property drawdown

property max_depletion

class pycap.wells.WellResponse(name, response_type, T, S, dist, Q, stream_apportionment=None, dd_method='Theis', depl_method='Glover', 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)

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’.

depl_method: string, optional

Method to be used for depletion calculations. Defaults to ‘Glover’.

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 Hunt99 depletion method [L/T]. Defaults to None

property depletion

property drawdown