Well classes

class wells.SteadyWell(x=0.0, y=0.0, r=0.05, q=0.0, pf=1, name='Steady state flowing well')

Bases: object

Steady state flowing well class.

The default SteadyWell object has coordinates x=0.0 and y=0.0, well radius r=0.05, penetration fraction pf=1.0 and well rate q=0.0. Exceptions occur if invalid values are provided for r or pf. The well rate can be negative, positive or zero and is used to set the .state attribute as extract, inject or off.

Attributes:

x (float) : Well x coordinate (units L, default 0.0). y (float) : Well y coordinate (units L, default 0.0). r (float) : Well radius (units L, default 0.05). q (float) : Well rate (units L3/T, default 0.0). pf (float) : Well penetration depth (fraction of aquifer depth,

default 1.0).

name (str) : Well name (default ‘’).

info()

Print the well information.

is_steady = True

is_transient = False

property pf

float : Well penetration depth.

Setter method checks for valid values and triggers an exception if invalid values are specified.

property r

float : Well radius.

Setter method checks for valid values and triggers an exception if invalid values are specified.

property state

str : Well state.

class wells.TransientWell(x=0.0, y=0.0, r=0.05, pf=1, name='Transient flowing well')

Bases: object

Transient state flowing well class.

The default TransientWell object has well coordinates x=0.0 and y=0.0, well radius r=0.05, penetration fraction pf=1.0 and default StressSeries object. Exceptions occur if invalid values are provided for r or pf. The well rate can be negative, positive or zero and is used to set the .state attribute as extract, inject or off.

Attributes:

x (float) : Well x coordinate (units L, default 0.0). y (float) : Well y coordinate (units L, default 0.0). r (float) : Well radius (units L, default 0.05). ss (obj) : StressSeries object. pf (float) : Well penetration depth (fraction of aquifer depth,

default 1.0).

name (str) : Well name (default ‘’).

class StressSeries(periods=[1.0], values=[0.0], from_csv='', title='Stress Series', xlabel='Time', ylabel='Value')

Bases: object

Stress series class defining sress periods and values.

The default StressSeries object has default values periods=[1.0] and values=[0.0]. Stress periods and values are provided in corresponding lists, which can be created manually or loaded from a csv file containig comma-separated period and value pairs, one per line. Exceptions occur if a period is negative or if the number of periods and stresses do not match.

The .plot method displays a timeseries graph of the stress series.

Example csv file with three stress periods:

10,25.6

15.2,38.7

48,-12

Attributes:

periods (float)List of stress period lengths; used if from_csv is

an empty string (units T, default [1.0]).

values (float)List of stress period values, one per stress period;

used if from_csv is an empty string (units consistent, default [0.0]).

from_csv (str)File path of csv file to read stress data from; no

data are read if the string is empty (default ‘’).

property periods

list (float) : List of stress period lengths.

Setter method checks for valid values and triggers an exception if invalid values are specified.

plot(dw=8)

Plot the stress series.

Args:

dw (float) : Width of figure (default 8).

property series

pandas dataframe : stress series dataframe.

property values

list (float) : List of stress period values.

Setter method checks for valid values and triggers an exception if invalid values are specified.

info()

Print the well information.

is_steady = False

is_transient = True

pandas = <module 'pandas' from '/home/docs/checkouts/readthedocs.org/user_builds/pygaf/envs/latest/lib/python3.7/site-packages/pandas/__init__.py'>

property pf

float : Well penetration depth.

Setter method checks for valid values and triggers an exception if invalid values are specified.

property r

float : Well radius.

Setter method checks for valid values and triggers an exception if invalid values are specified.

property state

str : Well state.

class wells.Well(x=0.0, y=0.0, r=0.05, pf=1.0, name='Steady state non-flowing well')

Bases: object

Non-flowing well class.

Attributes:

x (float) : Well x coordinate (units L, default 0.0). y (float) : Well y coordinate (units L, default 0.0). r (float) : Well radius (units L, default 0.05). pf (float) : Well penetration depth (fraction of aquifer depth,

default 1.0).

name (str) : Well name (default ‘’).

info()

Print the well information.

property pf

float : Well penetration depth.

Setter method checks for valid values and triggers an exception if invalid values are specified.

property r

float : Well radius.

Setter method checks for valid values and triggers an exception if invalid values are specified.