Mine pit inflow solutions

class pygaf.solutions.mine_flow.MineSteadyRadLeakyDD

Bases: object

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

Predict steady drawdown for a specified mine pit inflow. The MineSteadyRadleakyDD class uses the default Aq2dLeaky aquifer object with aquifer thickness 100 for the lower confined aquifer.

aq

Lower aquifer object.

Type:

obj

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.

A 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 will occur if invalid values are provided for K, Ss, B, Kleak or Bleak.

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

Ss

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

Type:

float

property B

Aquifer thickness (units L, default 10.0).

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

Type:

float

property Bleak

Leaky layer thickness (units L, default 10.0).

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

Type:

float

property D

Aquifer diffusivity (units L2/T, default 1.0e+4).

Type:

float

property K

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

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

Type:

float

property Kleak

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.

Type:

float

property S

Aquifer storage coefficient (units 1, default 1.0e-3).

Type:

float

property Ss

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.

Type:

float

draw(dw=6)

Display a drawing of the aquifer.

Parameters:

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.

Parameters:

• 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; results are exported if the string is not empty (default ‘’).

• 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).

Parameters:

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

draw(dw=8)

Display the definition diagram.

Parameters:

dw (float) – Width of figure (default 8.0).

property h0

Initial groundwater head (units L, default 120).

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

Type:

float

hr(r)

Head at sepcified radius (units L).

Parameters:

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

Parameters:

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

property lfac

Aquitard leakage factor (units L).

Type:

float

property qp

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

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

Type:

float

property ri

Radius of influence (units L).

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

Type:

float

property rp

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

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

Type:

float

class pygaf.solutions.mine_flow.MineSteadyRadUnconfQ

Bases: object

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

Predict steady mine inflow for a specified mine pit water level. The MineSteadyRadUnconfQ class uses the default Aq2dUnconf aquifer object with initial saturated thickness 100.

aq

Aquifer object.

Type:

obj

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

Bases: Aquifer

2D unconfined aquifer subclass.

A 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 will occur if invalid values are provided for K, Sy or B.

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

Sy

Aquifer specific yield (units 1, default 0.1).

Type:

float

property B

Aquifer thickness (units L, default 10.0).

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

Type:

float

property K

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

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

Type:

float

property S

Aquifer storage coefficient (units 1, default 0.1).

Type:

float

property Sy

Aquifer specific yield (units 1, default 0.1).

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

Type:

float

draw(dw=6)

Display a drawing of the aquifer.

Parameters:

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

Aquifer static water table elevation (units L reduced level, default 10.0).

Type:

float

property R

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.

Type:

float

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.

Parameters:

• 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; results are exported if the string is not empty (default ‘’).

• 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

Drawdown of mine pit water level from initial water table (units L, default 10).

Type:

float

dr(r)

Drawdown at specified radius (units L).

Parameters:

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

draw(dw=8)

Display the definition diagram.

Parameters:

dw (float) – Width of figure (default 8.0).

property hp

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

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

Type:

float

hr(r)

Head at specified radius (units L).

Parameters:

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

info()

Print the solution information.

property qp

Mine pit inflow rate (units L3/T).

Type:

float

property ri

Radius of influence (units L).

Type:

float

property rp

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

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

Type:

float

class pygaf.solutions.mine_flow.MineSteadyRadUnconfQ2

Bases: object

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

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

aq

Upper aquifer object.

Type:

obj

aq2kx

Horizontal hydraulic conductivity of lower aquifer (units L/T, default 1)

Type:

float

aq2kz

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

Type:

float

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

Bases: Aquifer

2D unconfined aquifer subclass.

A 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 will occur if invalid values are provided for K, Sy or B.

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

Sy

Aquifer specific yield (units 1, default 0.1).

Type:

float

property B

Aquifer thickness (units L, default 10.0).

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

Type:

float

property K

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

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

Type:

float

property S

Aquifer storage coefficient (units 1, default 0.1).

Type:

float

property Sy

Aquifer specific yield (units 1, default 0.1).

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

Type:

float

draw(dw=6)

Display a drawing of the aquifer.

Parameters:

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

Aquifer static water table elevation (units L reduced level, default 10.0).

Type:

float

property D

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

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

Type:

float

property R

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.

Type:

float

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.

Parameters:

• 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; results are exported if the string is not empty (default ‘’).

• 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

Drawdown of mine pit water level (units L, default 10).

Type:

float

dr(r)

Drawdown at radius r (units L).

Parameters:

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

draw(dw=8)

Display the definition diagram.

Parameters:

dw (float) – Width of figure (default 8.0).

property hp

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

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

Type:

float

hr(r)

Head at radius r (units L).

Parameters:

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

info()

Print the solution information.

property qp

Total mine pit inflow rate (units L3/T).

Type:

float

property qp1

Mine pit inflow rate from upper aquifer (units L3/T).

Type:

float

property qp2

Mine pit inflow rate from lower aquifer (units L3/T).

Type:

float

property ri

Radius of influence (units L).

Type:

float

property rp

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

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

Type:

float

class pygaf.solutions.mine_flow.MineSteadyStripLeakyDD

Bases: object

Steady, leaky 1D flow to mine pit wall.

Predict steady mine drawdown for a specified mine pit inflow. The MineSteadyStripLeakyDD class uses the default Aq2dLeaky aquifer object with aquifer thickness 100 for the lower confined aquifer.

aq

Aquifer object.

Type:

obj

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.

A 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 will occur if invalid values are provided for K, Ss, B, Kleak or Bleak.

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

Ss

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

Type:

float

property B

Aquifer thickness (units L, default 10.0).

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

Type:

float

property Bleak

Leaky layer thickness (units L, default 10.0).

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

Type:

float

property D

Aquifer diffusivity (units L2/T, default 1.0e+4).

Type:

float

property K

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

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

Type:

float

property Kleak

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.

Type:

float

property S

Aquifer storage coefficient (units 1, default 1.0e-3).

Type:

float

property Ss

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.

Type:

float

draw(dw=6)

Display a drawing of the aquifer.

Parameters:

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

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

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

Type:

float

property beta

Solution term (units L).

Type:

float

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.

Parameters:

• 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; results are exported if the string is not empty (default ‘’).

• 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

Mine pit drawdown (units L).

Type:

float

draw(dw=8)

Display the drawing definition.

Parameters:

dw (float) – Width of figure (default 8.0).

dx(x)

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

Parameters:

x (float) – Distance from pit wall (units L).

property h0

Initial groundwater head (units L, default 120).

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

Type:

float

property hp

Mine pit head (units L).

Type:

float

hx(x)

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

Parameters:

x (float) – Distance from pit wall (units L).

info()

Print the solution information.

property qp

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.

Type:

float

property xi

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

Type:

float

class pygaf.solutions.mine_flow.MineSteadyStripLeakyQ

Bases: object

Steady, leaky 1D flow to mine pit wall.

Predict steady mine inflow for a specified mine pit water level. The MineSteadyStripLeakyQ class uses the default Aq2dLeaky aquifer object with aquifer thickness 100 for the lower confined aquifer.

aq

Aquifer object.

Type:

obj

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.

A 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 will occur if invalid values are provided for K, Ss, B, Kleak or Bleak.

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

Ss

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

Type:

float

property B

Aquifer thickness (units L, default 10.0).

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

Type:

float

property Bleak

Leaky layer thickness (units L, default 10.0).

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

Type:

float

property D

Aquifer diffusivity (units L2/T, default 1.0e+4).

Type:

float

property K

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

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

Type:

float

property Kleak

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.

Type:

float

property S

Aquifer storage coefficient (units 1, default 1.0e-3).

Type:

float

property Ss

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.

Type:

float

draw(dw=6)

Display a drawing of the aquifer.

Parameters:

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

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

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

Type:

float

property beta

Solution term (units L).

Type:

float

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.

Parameters:

• 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; results are exported if the string is not empty (default ‘’).

• 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

Drawdown of mine pit water level from initial water table (units L, default 10).

Type:

float

draw(dw=8)

Display the drawing definition.

Parameters:

dw (float) – Width of figure (default 8.0).

dx(x)

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

Parameters:

x (float) – Distance from pit wall (units L).

property h0

Initial groundwater head (units L, default 120).

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

Type:

float

property hp

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

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

Type:

float

hx(x)

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

Parameters:

x (float) – Distance from pit wall (units L).

info()

Print the solution information.

property qp

Mine pit inflow rate (units L3/T).

Type:

float

property xi

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

Type:

float

class pygaf.solutions.mine_flow.MineSteadyStripUnconfQ

Bases: object

Steady, unconfined 1D flow to mine pit wall.

Predict steady mine inflow for a specified mine pit water level. The MineSteadyStripUnconfQ class uses the default Aq2dUnconf aquifer object with initial saturated thickness 100.

aq

Aquifer object.

Type:

obj

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

Bases: Aquifer

2D confined aquifer class.

A 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 will occur if invalid values are provided for K, Ss or B.

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

Ss

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

Type:

float

property B

Aquifer thickness (units L, default 10.0).

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

Type:

float

property D

Aquifer diffusivity (units L2/T, default 1.0e+4).

Type:

float

property K

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

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

Type:

float

property S

Aquifer storage coefficient (units 1, default 1.0e-3).

Type:

float

property Ss

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.

Type:

float

draw(dw=6)

Display a drawing of the aquifer.

Parameters:

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

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.

Type:

float

property Y

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

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

Type:

float

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.

Parameters:

• 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; results are exported if the string is not empty (default ‘’).

• 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

Drawdown of mine pit water level from initial water table (units L, default 10).

Type:

float

draw(dw=8)

Display the drawing definition.

Parameters:

dw (float) – Width of figure (default 8.0).

dx(x)

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

Parameters:

x (float) – Distance from pit wall (units L).

property hp

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

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

Type:

float

hx(x)

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

Parameters:

x (float) – Distance from pit wall (units L).

info()

Print the solution information.

property qp

Mine pit inflow rate (units L3/T).

Type:

float

property xi

Length of influence (units L).

Type:

float

class pygaf.solutions.mine_flow.MineTransRadConfDD

Bases: object

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

Predict transient drawdown for a specified mine pit inflow. The MineTransRadConfDD class uses the default Aq2dConf aquifer object with aquifer thickness 100 for the lower confined aquifer.

aq

Lower aquifer object.

Type:

obj

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

Bases: Aquifer

2D confined aquifer class.

A 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 will occur if invalid values are provided for K, Ss or B.

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

Ss

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

Type:

float

property B

Aquifer thickness (units L, default 10.0).

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

Type:

float

property D

Aquifer diffusivity (units L2/T, default 1.0e+4).

Type:

float

property K

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

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

Type:

float

property S

Aquifer storage coefficient (units 1, default 1.0e-3).

Type:

float

property Ss

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.

Type:

float

draw(dw=6)

Display a drawing of the aquifer.

Parameters:

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.

Parameters:

• 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; results are exported if the string is not empty (default ‘’).

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

Parameters:

• 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; results are exported if the string is not empty (default ‘’).

• 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

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

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

Type:

float

property dp_targ_time

Time at which the mine pit drawdown target is reached (units T).

Type:

float

draw(dw=8)

Display the drawing definition.

Parameters:

dw (float) – Width of figure (default 8.0).

drt(r, t)

Drawdown at specified radius and time (units L).

Parameters:

• r (float) – radius (units L).

• t (float) – time (units T).

property h0

Initial groundwater head (units L, default 110).

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

Type:

float

hrt(r, t)

Head at specified radius and time (units L).

Parameters:

• r (float) – radius (units L).

• t (float) – time (units T).

info()

Print the solution information.

property qp

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

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

Type:

float

ri(t)

Radius of influence at specified time.

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

Parameters:

t (float) – time (units T).

property rp

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

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

Type:

float

class pygaf.solutions.mine_flow.MineTransStripConfQ

Bases: object

Transient, confined 1D flow to mine pit wall.

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

aq

Aquifer object.

Type:

obj

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

Bases: Aquifer

2D confined aquifer class.

A 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 will occur if invalid values are provided for K, Ss or B.

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

Ss

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

Type:

float

property B

Aquifer thickness (units L, default 10.0).

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

Type:

float

property D

Aquifer diffusivity (units L2/T, default 1.0e+4).

Type:

float

property K

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

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

Type:

float

property S

Aquifer storage coefficient (units 1, default 1.0e-3).

Type:

float

property Ss

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.

Type:

float

draw(dw=6)

Display a drawing of the aquifer.

Parameters:

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

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

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

Type:

float

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.

Parameters:

• 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; results are exported if the string is not empty (default ‘’).

• 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

Drawdown of mine pit water level (units L).

Type:

float

draw(dw=8)

Display the drawing definition.

Parameters:

dw (float) – Width of figure (default 8.0).

dxt(x, t)

Drawdown at specified distance and time (units L).

Parameters:

• x (float) – distance from pit wall (units L).

• t (float) – time (units T).

property h0

Initial groundwater head (units L, default 110).

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

Type:

float

property hp

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

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

Type:

float

hxt(x, t)

Head at specified distance and time (units L).

Parameters:

• 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).

Parameters:

t (float) – time (units T)

qp_cum(t)

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

Parameters:

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

Parameters:

t (float) – time (units T)

class pygaf.solutions.mine_flow.MineTransStripLeakyQ

Bases: object

Transient, leaky 1D flow to mine pit wall.

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

aq

Aquifer object.

Type:

obj

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.

A 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 will occur if invalid values are provided for K, Ss, B, Kleak or Bleak.

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

Ss

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

Type:

float

property B

Aquifer thickness (units L, default 10.0).

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

Type:

float

property Bleak

Leaky layer thickness (units L, default 10.0).

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

Type:

float

property D

Aquifer diffusivity (units L2/T, default 1.0e+4).

Type:

float

property K

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

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

Type:

float

property Kleak

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.

Type:

float

property S

Aquifer storage coefficient (units 1, default 1.0e-3).

Type:

float

property Ss

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.

Type:

float

draw(dw=6)

Display a drawing of the aquifer.

Parameters:

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

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

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

Type:

float

property beta

Leakage factor.

Type:

float

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.

Parameters:

• 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; results are exported if the string is not empty (default ‘’).

• 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

Drawdown of mine pit water level (units L).

Type:

float

draw(dw=8)

Display the drawing definition.

Parameters:

dw (float) – Width of figure (default 8.0).

dxt(x, t)

Drawdown at specified distance and time (units L).

Parameters:

• x (float) – distance from pit wall (units L).

• t (float) – time (units T).

property h0

Initial groundwater head (units L, default 110).

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

Type:

float

property hp

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

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

Type:

float

hxt(x, t)

Head at specified distance and time (units L).

Parameters:

• 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).

Parameters:

t (float) – time (units T)

property qp_steady

Inflow to mine pit at steady state (units L3/T).

Type:

float

property xi_steady

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

class pygaf.solutions.mine_flow.MineTransStripUnconfQ

Bases: object

Transient, unconfined 1D flow to mine pit wall.

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

aq

Aquifer object.

Type:

obj

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

Bases: Aquifer

2D unconfined aquifer subclass.

A 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 will occur if invalid values are provided for K, Sy or B.

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

Sy

Aquifer specific yield (units 1, default 0.1).

Type:

float

property B

Aquifer thickness (units L, default 10.0).

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

Type:

float

property K

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

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

Type:

float

property S

Aquifer storage coefficient (units 1, default 0.1).

Type:

float

property Sy

Aquifer specific yield (units 1, default 0.1).

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

Type:

float

draw(dw=6)

Display a drawing of the aquifer.

Parameters:

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

Aquifer static water table elevation (units L reduced level, default 10.0).

Type:

float

property Y

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

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

Type:

float

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.

Parameters:

• 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; results are exported if the string is not empty (default ‘’).

• 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

Drawdown of mine pit water level (units L).

Type:

float

draw(dw=8)

Display the drawing definition.

Parameters:

dw (float) – Width of figure (default 8.0).

dxt(x, t)

Drawdown at specified distance and time (units L).

Parameters:

• x (float) – distance from pit wall (units L).

• t (float) – time (units T).

property hp

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

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

Type:

float

hxt(x, t)

Head at specified distance and time (units L).

Parameters:

• 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).

Parameters:

t (float) – time (units T)

qp_cum(t)

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

Parameters:

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

Parameters:

t (float) – time (units T)