Mine pit inflow

class mine_flow.MineSteadyRadLeakyDD

Bases: object

Steady, radial, leaky flow to a large diameter well.

Evaluate steady-state drawdown for a specified mine pit inflow. The MineSteadyRadleakyDD class adopts the default Aq2dLeaky aquifer object with aquifer thickness 100 for the confined aquifer.

Attributes:: aq (obj) : Lower aquifer object.

class Aq2dLeaky(K=1, Ss=0.0001, B=10, bot=0, Kleak=1e-05, Bleak=10, name='Aq2dLeaky class')

Bases: Aquifer

2D leaky aquifer subclass.

Subclass of the Aquifer class defining a horizontal, 2D leaky aquifer with infinite lateral extent and confined storage.

The default Aq2dLeak object has hydraulic conductivity K=1, specific storativity Ss=0.0001, aquifer saturated thickness B=10, aquifer bottom (datum) elevation bot=0, leaky hydraulic conductivity Kleak=0.00001 and leaky thickness Bleak=10. Exceptions occur if invalid values are provided for K, Ss, B, Kleak or Bleak.

The .info and .draw methods display the aquifer information and diagram.

Attributes:: Ss (float) : Aquifer specific storativity (units 1/L, default 1.0e-4).

property B

float : Aquifer thickness (units L, default 10.0).

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

property Bleak

float: Leaky layer thickness (units L, default 10.0).

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

property D: float : Aquifer diffusivity (units L2/T, default 1.0e+4).

property K

float : Aquifer hydraulic conductivity (units L/T, default 1.0).

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

property Kleak

float: Leaky layer hydraulic conductivity (units L/T, default 0.00001).

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

property S: float : Aquifer storage coefficient (units 1, default 1.0e-3).

property Ss

float : aquifer specific storativity (units 1/L, default 1.0e-4).

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

draw(dw=6)

Display a drawing of the aquifer.

Args:: dw (float) : Width of figure (default 6.0).

info(): Print the aquifer information.

is_1d = False

is_2d = True

is_confined = False

is_finite = False

is_heterogeneous = False

is_homogeneous = True

is_infinite = True

is_leaky = True

is_semifinite = False

is_unconfined = False

dd(n=25, plot=True, csv='', xlsx='')

Evaluate distance-drawdown.

Evaluate steady-state drawdown at specified distances from the mine pit wall. Results are returned in a Pandas dataframe. A drawdown graph is displayed as default and can be suppressed by setting plot=False.

Args:

n (int) : Number of radial values for evaluating drawdown (default 25). plot (bool) : Display a plot of results (default True). csv (str) : Full filepath for export of results to csv file;

xlsx (str)Full filepath for export of result to xlsx file;: results are exported if the string is not empty (default ‘’).

Returns:

Results in a pandas dataframe.

dr(r)

Drawdown at specified radius (units L).

Args:: r (float) : radius at which to evaluate drawdown (units L).

draw(dw=8)

Display the definition diagram.

Args:: dw (float) : Width of figure (default 8.0).

property h0

float : Initial groundwater head (units L, default 120).

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

hr(r)

Head at sepcified radius (units L).

Args:: r (float) : radius at which to evaluate head (units L).

info(): Print the solution information.

leakr(r)

Leakage rate at specified radius (units L/T).

Args:: r (float) : radius at which to evaluate leakage (units L).

property lfac: float : Aquitard leakage factor (units L).

property qp

float : Mine pit inflow rate (units L/T, default 1000).

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

property ri

float : Radius of influence (units L).

Defined as radius at which drawdown is less than 0.1% of initial groundwater head.

property rp

float : Equivalent radius of mine pit (units L, default 100).

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

class mine_flow.MineSteadyRadUnconfQ

Bases: object

Steady, radial, unconfined flow to a large diameter well.

Evaluate steady-state mine inflow for a specified mine pit water level. The MineSteadyRadUnconfQ class adopts the default Aq2dUnconf aquifer object with initial saturated thickness 100.

Attributes:: aq (obj) : Aquifer object.

class Aq2dUnconf(K=1, Sy=0.1, B=10, bot=0, name='Aq2dUnconf class')

Bases: Aquifer

2D unconfined aquifer subclass.

Subclass of the Aquifer class defining a horizontal, 2D unconfined aquifer with infinite lateral extent and unconfined storage.

The default Aq2dUnconf object has hydraulic conductivity K=1, specific yield Sy=0.1, static saturated thickness B=10 and aquifer bottom (datum) elevation bot=0. Exceptions occur if invalid values are provided for K, Sy or B.

The .info and .draw methods display the aquifer information and diagram.

Attributes:: Sy (float) : Aquifer specific yield (units 1, default 0.1).

property B

float : Aquifer thickness (units L, default 10.0).

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

property K

float : Aquifer hydraulic conductivity (units L/T, default 1.0).

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

property S: float : Aquifer storage coefficient (units 1, default 0.1).

property Sy

float : Aquifer specific yield (units 1, default 0.1).

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

draw(dw=6)

Display a drawing of the aquifer.

Args:: dw (float) : Width of figure (default 6.0).

info(): Print the aquifer information.

is_1d = False

is_2d = True

is_confined = False

is_finite = False

is_heterogeneous = False

is_homogeneous = True

is_infinite = True

is_leaky = False

is_semifinite = False

is_unconfined = True

property swl: float : Aquifer static water table elevation (units L reduced level, default 10.0).

property R

float : Groundwater recharge rate (units L/T, default 1.0e-4).

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

dd(n=25, plot=True, csv='', xlsx='')

Evaluate distance-drawdown (units L).

Evaluate steady-state drawdown at specified distances from the mine pit wall. Results are returned in a Pandas dataframe. A drawdown graph is displayed as default and can be suppressed by setting plot=False.

Args:

n (int) : Number of radial values for evaluating drawdown (default 25). plot (bool) : Display a plot of results (default True). csv (str) : Full filepath for export of results to csv file;

xlsx (str)Full filepath for export of result to xlsx file;: results are exported if the string is not empty (default ‘’).

Returns:

Results in a pandas dataframe.

property dp: float : Drawdown of mine pit water level from initial water table (units L, default 10).

dr(r)

Drawdown at specified radius (units L).

Args:: r (float) : Radius at which to evaluate head (units L).

draw(dw=8)

Display the definition diagram.

Args:: dw (float) : Width of figure (default 8.0).

property hp

float : Mine pit water level (units L, default 90).

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

hr(r)

Head at specified radius (units L).

Args:: r (float) : Radius at which to evaluate head (units L).

info(): Print the solution information.

property qp: float : Mine pit inflow rate (units L3/T).

property ri: float : Radius of influence (units L).

property rp

float : Equivalent radius of mine pit (units L, default 100).

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

class mine_flow.MineSteadyRadUnconfQ2

Bases: object

Steady, radial, unconfined flow to a large diameter well with pit floor inflow.

Evaluate steady-state mine inflow for a specified mine pit water level. The MineSteadyRadUnconfQ2 class adopts the default Aq2dUnconf aquifer object with initial saturated thickness 100 for the upper unconfined aquifer.

Attributes:

aq (obj) : Upper aquifer object. aq2kx (float) : Horizontal hydraulic conductivity of lower aquifer

aq2kz (float)Vertical hydraulic conductivity of lower aquifer: (units L/T, default 1)

class Aq2dUnconf(K=1, Sy=0.1, B=10, bot=0, name='Aq2dUnconf class')

Bases: Aquifer

2D unconfined aquifer subclass.

Subclass of the Aquifer class defining a horizontal, 2D unconfined aquifer with infinite lateral extent and unconfined storage.

The default Aq2dUnconf object has hydraulic conductivity K=1, specific yield Sy=0.1, static saturated thickness B=10 and aquifer bottom (datum) elevation bot=0. Exceptions occur if invalid values are provided for K, Sy or B.

The .info and .draw methods display the aquifer information and diagram.

Attributes:: Sy (float) : Aquifer specific yield (units 1, default 0.1).

property B

float : Aquifer thickness (units L, default 10.0).

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

property K

float : Aquifer hydraulic conductivity (units L/T, default 1.0).

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

property S: float : Aquifer storage coefficient (units 1, default 0.1).

property Sy

float : Aquifer specific yield (units 1, default 0.1).

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

draw(dw=6)

Display a drawing of the aquifer.

Args:: dw (float) : Width of figure (default 6.0).

info(): Print the aquifer information.

is_1d = False

is_2d = True

is_confined = False

is_finite = False

is_heterogeneous = False

is_homogeneous = True

is_infinite = True

is_leaky = False

is_semifinite = False

is_unconfined = True

property swl: float : Aquifer static water table elevation (units L reduced level, default 10.0).

property D

float : Depth of mine pit lake (units L, default 0).

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

property R

float : Groundwater recharge rate (units L/T, default 1.0e-4).

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

dd(n=25, plot=True, csv='', xlsx='')

Evaluate distance-drawdown (units L).

Evaluate steady-state drawdown at specified distances from the mine pit wall. Results are returned in a Pandas dataframe. A drawdown graph is displayed as default and can be suppressed by setting plot=False.

Args:

n (int) : Number of radial values for evaluating drawdown (default 25). plot (bool) : Display a plot of results (default True). csv (str) : Full filepath for export of results to csv file;

xlsx (str)Full filepath for export of result to xlsx file;: results are exported if the string is not empty (default ‘’).

Returns:

Results in a pandas dataframe.

property dp: float : Drawdown of mine pit water level (units L, default 10).

dr(r)

Drawdown at radius r (units L).

Args:: r (float) : radius at which to evaluate drawdown (units L).

draw(dw=8)

Display the definition diagram.

Args:: dw (float) : Width of figure (default 8.0).

property hp

float : Mine pit water level (units L, default 90).

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

hr(r)

Head at radius r (units L).

Args:: r (float) : radius at which to evaluate head (units L).

info(): Print the solution information.

property qp: float : Total mine pit inflow rate (units L3/T).

property qp1: float : Mine pit inflow rate from upper aquifer (units L3/T).

property qp2: float : Mine pit inflow rate from lower aquifer (units L3/T).

property ri: float : Radius of influence (units L).

property rp

float : Equivalent radius of mine pit (units L, default 100).

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

class mine_flow.MineSteadyStripLeakyDD

Bases: object

Steady, leaky 1D flow to mine pit wall.

Evaluate steady-state mine drawdown for a specified mine pit inflow. The MineSteadyStripLeakyDD class adopts the default Aq2dLeaky aquifer object with aquifer thickness 100 for the confined aquifer.

Attributes:: aq (obj) : Aquifer object.

class Aq2dLeaky(K=1, Ss=0.0001, B=10, bot=0, Kleak=1e-05, Bleak=10, name='Aq2dLeaky class')

Bases: Aquifer

2D leaky aquifer subclass.

Subclass of the Aquifer class defining a horizontal, 2D leaky aquifer with infinite lateral extent and confined storage.

The default Aq2dLeak object has hydraulic conductivity K=1, specific storativity Ss=0.0001, aquifer saturated thickness B=10, aquifer bottom (datum) elevation bot=0, leaky hydraulic conductivity Kleak=0.00001 and leaky thickness Bleak=10. Exceptions occur if invalid values are provided for K, Ss, B, Kleak or Bleak.

The .info and .draw methods display the aquifer information and diagram.

Attributes:: Ss (float) : Aquifer specific storativity (units 1/L, default 1.0e-4).

property B

float : Aquifer thickness (units L, default 10.0).

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

property Bleak

float: Leaky layer thickness (units L, default 10.0).

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

property D: float : Aquifer diffusivity (units L2/T, default 1.0e+4).

property K

float : Aquifer hydraulic conductivity (units L/T, default 1.0).

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

property Kleak

float: Leaky layer hydraulic conductivity (units L/T, default 0.00001).

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

property S: float : Aquifer storage coefficient (units 1, default 1.0e-3).

property Ss

float : aquifer specific storativity (units 1/L, default 1.0e-4).

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

draw(dw=6)

Display a drawing of the aquifer.

Args:: dw (float) : Width of figure (default 6.0).

info(): Print the aquifer information.

is_1d = False

is_2d = True

is_confined = False

is_finite = False

is_heterogeneous = False

is_homogeneous = True

is_infinite = True

is_leaky = True

is_semifinite = False

is_unconfined = False

property Y

float : Length of mine strip (units L, default 1000).

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

property beta: float : Solution term (units L).

dd(n=25, plot=True, csv='', xlsx='')

Evaluate distance-drawdown (units L).

Evaluate steady-state drawdown at specified distances from the mine pit wall. Results are returned in a Pandas dataframe. A drawdown graph is displayed as default and can be suppressed by setting plot=False.

Args:

n (int) : Number of values for evaluating drawdown (default 25). plot (bool) : Display a plot of results (default True). csv (str) : Full filepath for export of results to csv file;

xlsx (str)Full filepath for export of result to xlsx file;: results are exported if the string is not empty (default ‘’).

Returns:

Results in a pandas dataframe.

property dp: float : Mine pit drawdown (units L).

draw(dw=8)

Display the drawing definition.

Args:: dw (float) : Width of figure (default 8.0).

dx(x)

Drawdown at specified distance from pit wall (unit L).

Args:: x (float) : Distance from pit wall (units L).

property h0

float : Initial groundwater head (units L, default 120).

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

property hp: float : Mine pit head (units L).

hx(x)

Head at specified distance from pit wall (units L).

Args:: x (float) : Distance from pit wall (units L).

info(): Print the solution information.

property qp

float : Mine pit inflow rate (units L/T, default 0.0).

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

property xi: float : Length of influence defined where drawdown is equal to 0.1% of initial aquifer head (units L).

class mine_flow.MineSteadyStripLeakyQ

Bases: object

Steady, leaky 1D flow to mine pit wall.

Evaluate steady-state mine inflow for a specified mine pit water level. The MineSteadyStripLeakyQ class adopts the default Aq2dLeaky aquifer object with aquifer thickness 100 for the confined aquifer.

Attributes:: aq (obj) : Aquifer object.

class Aq2dLeaky(K=1, Ss=0.0001, B=10, bot=0, Kleak=1e-05, Bleak=10, name='Aq2dLeaky class')

Bases: Aquifer

2D leaky aquifer subclass.

Subclass of the Aquifer class defining a horizontal, 2D leaky aquifer with infinite lateral extent and confined storage.

The default Aq2dLeak object has hydraulic conductivity K=1, specific storativity Ss=0.0001, aquifer saturated thickness B=10, aquifer bottom (datum) elevation bot=0, leaky hydraulic conductivity Kleak=0.00001 and leaky thickness Bleak=10. Exceptions occur if invalid values are provided for K, Ss, B, Kleak or Bleak.

The .info and .draw methods display the aquifer information and diagram.

Attributes:: Ss (float) : Aquifer specific storativity (units 1/L, default 1.0e-4).

property B

float : Aquifer thickness (units L, default 10.0).

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

property Bleak

float: Leaky layer thickness (units L, default 10.0).

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

property D: float : Aquifer diffusivity (units L2/T, default 1.0e+4).

property K

float : Aquifer hydraulic conductivity (units L/T, default 1.0).

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

property Kleak

float: Leaky layer hydraulic conductivity (units L/T, default 0.00001).

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

property S: float : Aquifer storage coefficient (units 1, default 1.0e-3).

property Ss

float : aquifer specific storativity (units 1/L, default 1.0e-4).

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

draw(dw=6)

Display a drawing of the aquifer.

Args:: dw (float) : Width of figure (default 6.0).

info(): Print the aquifer information.

is_1d = False

is_2d = True

is_confined = False

is_finite = False

is_heterogeneous = False

is_homogeneous = True

is_infinite = True

is_leaky = True

is_semifinite = False

is_unconfined = False

property Y

float : Length of mine strip (units L, default 1000).

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

property beta: float : Solution term (units L).

dd(n=25, plot=True, csv='', xlsx='')

Evaluate distance-drawdown (units L).

Evaluate steady-state drawdown at specified distances from the mine pit wall. Results are returned in a Pandas dataframe. A drawdown graph is displayed as default and can be suppressed by setting plot=False.

Args:

n (int) : Number of values for evaluating drawdown (default 25). plot (bool) : Display a plot of results (default True). csv (str) : Full filepath for export of results to csv file;

xlsx (str)Full filepath for export of result to xlsx file;: results are exported if the string is not empty (default ‘’).

Returns:

Results in a pandas dataframe.

property dp: float : Drawdown of mine pit water level from initial water table (units L, default 10).

draw(dw=8)

Display the drawing definition.

Args:: dw (float) : Width of figure (default 8.0).

dx(x)

Drawdown at specified distance from pit wall (unit L).

Args:: x (float) : Distance from pit wall (units L).

property h0

float : Initial groundwater head (units L, default 120).

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

property hp

float : Mine pit water level (units L, default 90).

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

hx(x)

Head at specified distance from pit wall (units L).

Args:: x (float) : Distance from pit wall (units L).

info(): Print the solution information.

property qp: float : Mine pit inflow rate (units L3/T).

property xi: float : Length of influence defined where drawdown is equal to 0.1% of initial aquifer head (units L).

class mine_flow.MineSteadyStripUnconfQ

Bases: object

Steady, unconfined 1D flow to mine pit wall.

Evaluate steady-state mine inflow for a specified mine pit water level. The MineSteadyStripUnconfQ class adopts the default Aq2dUnconf aquifer object with initial saturated thickness 100.

Attributes:: aq (obj) : Aquifer object.

class Aq2dConf(K=1, Ss=0.0001, B=10, bot=0, name='Aq2dConf class')

Bases: Aquifer

2D confined aquifer class.

Subclass of the Aquifer class defining a horizontal, 2D confined aquifer with infinite lateral extent and confined storage.

The default Aq2dConf object has hydraulic conductivity K=1, specific storativity Ss=0.0001, aquifer saturated thickness B=10 and aquifer bottom (datum) elevation bot=0. Exceptions occur if invalid values are provided for K, Ss or B.

The .info and .draw methods display the aquifer information and diagram.

Attributes:: Ss (float) : Aquifer specific storativity (units 1/L, default 1.0e-4).

property B

float : Aquifer thickness (units L, default 10.0).

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

property D: float : Aquifer diffusivity (units L2/T, default 1.0e+4).

property K

float : Aquifer hydraulic conductivity (units L/T, default 1.0).

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

property S: float : Aquifer storage coefficient (units 1, default 1.0e-3).

property Ss

float : aquifer specific storativity (units 1/L, default 1.0e-4).

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

draw(dw=6)

Display a drawing of the aquifer.

Args:: dw (float) : Width of figure (default 6.0).

info(): Print the aquifer information.

is_1d = False

is_2d = True

is_confined = True

is_finite = False

is_heterogeneous = False

is_homogeneous = True

is_infinite = True

is_leaky = False

is_semifinite = False

is_unconfined = False

property R

float : Groundwater recharge rate (units L/T, default 1.0e-4).

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

property Y

float : Length of mine strip (units L, default 1000).

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

dd(n=25, plot=True, csv='', xlsx='')

Evaluate distance-drawdown (units L).

Evaluate steady-state drawdown at specified distances from the mine pit wall. Results are returned in a Pandas dataframe. A drawdown graph is displayed as default and can be suppressed by setting plot=False.

Args:

n (int) : Number of values for evaluating drawdown (default 25). plot (bool) : Display a plot of results (default True). csv (str) : Full filepath for export of results to csv file;

xlsx (str)Full filepath for export of result to xlsx file;: results are exported if the string is not empty (default ‘’).

Returns:

Results in a pandas dataframe.

property dp: float : Drawdown of mine pit water level from initial water table (units L, default 10).

draw(dw=8)

Display the drawing definition.

Args:: dw (float) : Width of figure (default 8.0).

dx(x)

Drawdown at specified distance from pit wall (unit L).

Args:: x (float) : Distance from pit wall (units L).

property hp

float : Mine pit water level (units L, default 90).

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

hx(x)

Head at specified distance from pit wall (units L).

Args:: x (float) : Distance from pit wall (units L).

info(): Print the solution information.

property qp: float : Mine pit inflow rate (units L3/T).

property xi: float : Length of influence (units L).

class mine_flow.MineTransRadConfDD

Bases: object

Transient, radial, confined flow to a large diameter well.

Evaluate transient drawdown for a specified mine pit inflow. The MineTransRadConfDD class adopts the default Aq2dConf aquifer object with aquifer thickness 100.

Attributes:: aq (obj) : Lower aquifer object.

class Aq2dConf(K=1, Ss=0.0001, B=10, bot=0, name='Aq2dConf class')

Bases: Aquifer

2D confined aquifer class.

Subclass of the Aquifer class defining a horizontal, 2D confined aquifer with infinite lateral extent and confined storage.

The default Aq2dConf object has hydraulic conductivity K=1, specific storativity Ss=0.0001, aquifer saturated thickness B=10 and aquifer bottom (datum) elevation bot=0. Exceptions occur if invalid values are provided for K, Ss or B.

The .info and .draw methods display the aquifer information and diagram.

Attributes:: Ss (float) : Aquifer specific storativity (units 1/L, default 1.0e-4).

property B

float : Aquifer thickness (units L, default 10.0).

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

property D: float : Aquifer diffusivity (units L2/T, default 1.0e+4).

property K

float : Aquifer hydraulic conductivity (units L/T, default 1.0).

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

property S: float : Aquifer storage coefficient (units 1, default 1.0e-3).

property Ss

float : aquifer specific storativity (units 1/L, default 1.0e-4).

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

draw(dw=6)

Display a drawing of the aquifer.

Args:: dw (float) : Width of figure (default 6.0).

info(): Print the aquifer information.

is_1d = False

is_2d = True

is_confined = True

is_finite = False

is_heterogeneous = False

is_homogeneous = True

is_infinite = True

is_leaky = False

is_semifinite = False

is_unconfined = False

dd(t, n=25, plot=True, csv='', xlsx='')

Evaluate radial-drawdown at specified time.

Results are returned in a Pandas dataframe. A drawdown graph is displayed as default and can be suppressed by setting plot=False.

Args:

t (float) : Time for evaluating drawdown (units T). n (int) : Number of radial values for evaluating drawdown (default 25). plot (bool) : Display a plot of results (default True). csv (str) : Full filepath for export of results to csv file;

xlsx (str)Full filepath for export of result to xlsx file;: results are exported if the string is not empty (default ‘’).

Returns:

Results in a pandas dataframe.

dp(n=25, plot=True, csv='', xlsx='')

Transient drawdown of mine pit water level.

Evaluate transient drawdown of the water level in the mine pit. Results are returned in a Pandas dataframe. A drawdown graph is displayed as default and can be suppressed by setting plot=False.

Args:

n (int) : Number of radial values for evaluating drawdown (default 25). plot (bool) : Display a plot of results (default True). csv (str) : Full filepath for export of results to csv file;

xlsx (str)Full filepath for export of result to xlsx file;: results are exported if the string is not empty (default ‘’).

Returns:

Results in a pandas dataframe.

property dp_targ

float : Mine pit drawdown target (units L, default 10).

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

property dp_targ_time: float : Time at which the mine pit drawdown target is reached (units T).

draw(dw=8)

Display the drawing definition.

Args:: dw (float) : Width of figure (default 8.0).

drt(r, t)

Drawdown at specified radius and time (units L).

Args:: r (float) : radius (units L). t (float) : time (units T).

property h0

float : Initial groundwater head (units L, default 110).

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

hrt(r, t)

Head at specified radius and time (units L).

Args:: r (float) : radius (units L). t (float) : time (units T).

info(): Print the solution information.

property qp

float : Mine pit inflow rate (units L/T, default 1000).

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

ri(t)

Radius of influence at specified time.

Defined as radius within which change in storage is equal to 95% of total discharge.

Args:: t (float) : time (units T).

property rp

float : Equivalent radius of mine pit (units L, default 100).

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

class mine_flow.MineTransStripConfQ

Bases: object

Transient, confined 1D flow to mine pit wall.

Evaluate transient inflow for a specified mine pit water level. The MineTransStripConfQ class adopts the default Aq2dConf aquifer object with aquifer thickness 100.

Attributes:: aq (obj) : Aquifer object.

class Aq2dConf(K=1, Ss=0.0001, B=10, bot=0, name='Aq2dConf class')

Bases: Aquifer

2D confined aquifer class.

Subclass of the Aquifer class defining a horizontal, 2D confined aquifer with infinite lateral extent and confined storage.

The default Aq2dConf object has hydraulic conductivity K=1, specific storativity Ss=0.0001, aquifer saturated thickness B=10 and aquifer bottom (datum) elevation bot=0. Exceptions occur if invalid values are provided for K, Ss or B.

The .info and .draw methods display the aquifer information and diagram.

Attributes:: Ss (float) : Aquifer specific storativity (units 1/L, default 1.0e-4).

property B

float : Aquifer thickness (units L, default 10.0).

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

property D: float : Aquifer diffusivity (units L2/T, default 1.0e+4).

property K

float : Aquifer hydraulic conductivity (units L/T, default 1.0).

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

property S: float : Aquifer storage coefficient (units 1, default 1.0e-3).

property Ss

float : aquifer specific storativity (units 1/L, default 1.0e-4).

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

draw(dw=6)

Display a drawing of the aquifer.

Args:: dw (float) : Width of figure (default 6.0).

info(): Print the aquifer information.

is_1d = False

is_2d = True

is_confined = True

is_finite = False

is_heterogeneous = False

is_homogeneous = True

is_infinite = True

is_leaky = False

is_semifinite = False

is_unconfined = False

property Y

float : Length of mine strip (units L, default 1000).

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

dd(t, n=25, plot=True, csv='', xlsx='')

Evaluate distance-drawdown at specified time(units L).

Evaluate drawdown at specified distances from the mine pit wall at specified time. Results are returned in a Pandas dataframe. A drawdown grapph is displayed as default and can be suppressed by setting plot=False.

Args:

t (float) : Time (units T) n (int) : Number of values for evaluating drawdown (default 25). plot (bool) : Display a plot of results (default True). csv (str) : Full filepath for export of results to csv file;

xlsx (str)Full filepath for export of result to xlsx file;: results are exported if the string is not empty (default ‘’).

Returns:

Results in a pandas dataframe.

property dp: float : Drawdown of mine pit water level (units L).

draw(dw=8)

Display the drawing definition.

Args:: dw (float) : Width of figure (default 8.0).

dxt(x, t)

Drawdown at specified distance and time (units L).

Args:: x (float) : distance from pit wall (units L). t (float) : time (units T).

property h0

float : Initial groundwater head (units L, default 110).

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

property hp

float : Mine pit water level (units L, default 90).

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

hxt(x, t)

Head at specified distance and time (units L).

Args:: x (float) : distance from pit wall (units L). t (float) : time (units T).

info(): Print the solution information.

qp(t)

Inflow to mine pit at specified time (units L3/T).

Args:: t (float) : time (units T)

qp_cum(t)

Cumulative inflow to mine pit at specified time (units L3).

Args:: t (float) : time (units T)

xi(t)

Length of influence at specified time, defined where drawdown is equal to 0.1% of initial aquifer head (units L).

Args:: t (float) : time (units T)

class mine_flow.MineTransStripLeakyQ

Bases: object

Transient, leaky 1D flow to mine pit wall.

Evaluate transient inflow for a specified mine pit water level. The MineTransStripLeakyQ class adopts the default Aq2dLeaky aquifer object with aquifer thickness 100.

Attributes:: aq (obj) : Aquifer object.

class Aq2dLeaky(K=1, Ss=0.0001, B=10, bot=0, Kleak=1e-05, Bleak=10, name='Aq2dLeaky class')

Bases: Aquifer

2D leaky aquifer subclass.

Subclass of the Aquifer class defining a horizontal, 2D leaky aquifer with infinite lateral extent and confined storage.

The default Aq2dLeak object has hydraulic conductivity K=1, specific storativity Ss=0.0001, aquifer saturated thickness B=10, aquifer bottom (datum) elevation bot=0, leaky hydraulic conductivity Kleak=0.00001 and leaky thickness Bleak=10. Exceptions occur if invalid values are provided for K, Ss, B, Kleak or Bleak.

The .info and .draw methods display the aquifer information and diagram.

Attributes:: Ss (float) : Aquifer specific storativity (units 1/L, default 1.0e-4).

property B

float : Aquifer thickness (units L, default 10.0).

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

property Bleak

float: Leaky layer thickness (units L, default 10.0).

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

property D: float : Aquifer diffusivity (units L2/T, default 1.0e+4).

property K

float : Aquifer hydraulic conductivity (units L/T, default 1.0).

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

property Kleak

float: Leaky layer hydraulic conductivity (units L/T, default 0.00001).

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

property S: float : Aquifer storage coefficient (units 1, default 1.0e-3).

property Ss

float : aquifer specific storativity (units 1/L, default 1.0e-4).

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

draw(dw=6)

Display a drawing of the aquifer.

Args:: dw (float) : Width of figure (default 6.0).

info(): Print the aquifer information.

is_1d = False

is_2d = True

is_confined = False

is_finite = False

is_heterogeneous = False

is_homogeneous = True

is_infinite = True

is_leaky = True

is_semifinite = False

is_unconfined = False

property Y

float : Length of mine strip (units L, default 1000).

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

property beta: float : Leakage factor.

dd(t, n=25, plot=True, csv='', xlsx='')

Evaluate distance-drawdown at specified time(units L).

Evaluate drawdown at specified distances from the mine pit wall at specified time. Results are returned in a Pandas dataframe. A drawdown grapph is displayed as default and can be suppressed by setting plot=False.

Args:

t (float) : Time (units T) n (int) : Number of values for evaluating drawdown (default 25). plot (bool) : Display a plot of results (default True). csv (str) : Full filepath for export of results to csv file;

xlsx (str)Full filepath for export of result to xlsx file;: results are exported if the string is not empty (default ‘’).

Returns:

Results in a pandas dataframe.

property dp: float : Drawdown of mine pit water level (units L).

draw(dw=8)

Display the drawing definition.

Args:: dw (float) : Width of figure (default 8.0).

dxt(x, t)

Drawdown at specified distance and time (units L).

Args:: x (float) : distance from pit wall (units L). t (float) : time (units T).

property h0

float : Initial groundwater head (units L, default 110).

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

property hp

float : Mine pit water level (units L, default 90).

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

hxt(x, t)

Head at specified distance and time (units L).

Args:: x (float) : distance from pit wall (units L). t (float) : time (units T).

info(): Print the solution information.

qp(t)

Inflow to mine pit at specified time (units L3/T).

Args:: t (float) : time (units T)

property qp_steady: float : Inflow to mine pit at steady state (units L3/T).

property xi_steady: Length of influence at specified time, defined where drawdown is equal to 0.1% of initial aquifer head (units L).

class mine_flow.MineTransStripUnconfQ

Bases: object

Transient, unconfined 1D flow to mine pit wall.

Evaluate transient inflow for a specified mine pit water level. The MineTransStripUnconfQ class adopts the default Aq2dUnconf aquifer object with initial saturated thickness 100.

Attributes:: aq (obj) : Aquifer object.

class Aq2dUnconf(K=1, Sy=0.1, B=10, bot=0, name='Aq2dUnconf class')

Bases: Aquifer

2D unconfined aquifer subclass.

Subclass of the Aquifer class defining a horizontal, 2D unconfined aquifer with infinite lateral extent and unconfined storage.

The default Aq2dUnconf object has hydraulic conductivity K=1, specific yield Sy=0.1, static saturated thickness B=10 and aquifer bottom (datum) elevation bot=0. Exceptions occur if invalid values are provided for K, Sy or B.

The .info and .draw methods display the aquifer information and diagram.

Attributes:: Sy (float) : Aquifer specific yield (units 1, default 0.1).

property B

float : Aquifer thickness (units L, default 10.0).

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

property K

float : Aquifer hydraulic conductivity (units L/T, default 1.0).

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

property S: float : Aquifer storage coefficient (units 1, default 0.1).

property Sy

float : Aquifer specific yield (units 1, default 0.1).

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

draw(dw=6)

Display a drawing of the aquifer.

Args:: dw (float) : Width of figure (default 6.0).

info(): Print the aquifer information.

is_1d = False

is_2d = True

is_confined = False

is_finite = False

is_heterogeneous = False

is_homogeneous = True

is_infinite = True

is_leaky = False

is_semifinite = False

is_unconfined = True

property swl: float : Aquifer static water table elevation (units L reduced level, default 10.0).

property Y

float : Length of mine strip (units L, default 1000).

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

dd(t, n=25, plot=True, csv='', xlsx='')

Evaluate distance-drawdown at specified time(units L).

Evaluate drawdown at specified distances from the mine pit wall at specified time. Results are returned in a Pandas dataframe. A drawdown grapph is displayed as default and can be suppressed by setting plot=False.

Args:

t (float) : Time (units T) n (int) : Number of values for evaluating drawdown (default 25). plot (bool) : Display a plot of results (default True). csv (str) : Full filepath for export of results to csv file;

xlsx (str)Full filepath for export of result to xlsx file;: results are exported if the string is not empty (default ‘’).

Returns:

Results in a pandas dataframe.

property dp: float : Drawdown of mine pit water level (units L).

draw(dw=8)

Display the drawing definition.

Args:: dw (float) : Width of figure (default 8.0).

dxt(x, t)

Drawdown at specified distance and time (units L).

Args:: x (float) : distance from pit wall (units L). t (float) : time (units T).

property hp

float : Mine pit water level (units L, default 90).

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

hxt(x, t)

Head at specified distance and time (units L).

Args:: x (float) : distance from pit wall (units L). t (float) : time (units T).

info(): Print the solution information.

qp(t)

Inflow to mine pit at specified time (units L3/T).

Args:: t (float) : time (units T)

qp_cum(t)

Cumulative inflow to mine pit at specified time (units L3).

Args:: t (float) : time (units T)

xi(t)

Length of influence at specified time, defined where drawdown is equal to 0.1% of initial aquifer head (units L).

Args:: t (float) : time (units T)