Oden Institute for Computational Engineering and Sciences / Jackson School of Geosciences / University of Texas Institute for Geophysics The University of Texas at Austin
This codes solves the Polubarina-Kochina equations for low aspect ratio dam problems where upper lake level is close to the length of the dam. The GUI standalone executables are compatible with Mac and Windows (available here). The results have been validated with [2].
L: Length of dam [L], H: Lower lake height [L], H1: Upper lake height [L], H0: Seepage face height [L], C: Pbk parameter [L], Alpha: Pbk parameter [-], Beta: Pbk parameter [-], z: Free surface height [L], x: horizontal dimension [L], Q: Total flow rate by width in third dimension [L^2/T], Q_H0/Q_H: Ratio of flow rate from seepage face vs from lake [-]
-
Download the executables (https://github.com/mashadab/Polubarinova-Kochina-solutions/blob/main/Executables.zip).
-
Run the exe file (takes a few seconds to boot).:
a. Mac: - If it does not recognize the file, then: - Change permissions of the file using
chmod 777 Pbk_Mac
- Choose Apple menu > System Preferences, click Security & Privacy, then click General. You can grant an exception for a blocked app by clicking the “Open Anyway” button in the General pane (takes about 2-10 minutes to appear).b. Windows: Run as Administrator
Dependences for Python program
- Python version 3.5+
- Numpy >= 1.16
- scipy >=1.5
- PySimpleGUI >= 4.55.1
- Matplotlib >= 3.5.0
-
Install the dependencies in a "Spyder" environment:
i. For windows, remove scipy and numpy installed in conda and install using pip
conda remove --force numpy, scipy
conda install python=3.7
pip install numpy
pip install scipy
pip install matplotlib
pip install PySimpleGUI
- Download the github repository and unzip the package contents or clone the repository.
git clone https://github.com/mashadab/Polubarinova-Kochina-solutions
- Run the python program "Pbk_GUI.py" in Spyder environment
The output files include:
- details.csv: Information regading the input and output variables
- free-surface-profiles_XandZ.csv: Free surface profile (X vs Z)
- free-surface-profile.pdf: High-res image of the output figure
- free-surface-profile.png: Low-res image of the output figure
- Mohammad Afzal Shadab (mashadab@utexas.edu)
- Eric Hiatt (eric.hiatt@utexas.edu)
- Marc Andre Hesse (mhesse@jsg.utexas.edu)
[1] Shadab, M.A., Hiatt, E. and Hesse, M.A.,2022. Polubarinova-Kochina solutions for steady unconfined groundwater flow: a free tool and its applicability. (submitted).
[2] Kochina, P., 1962. Theory of ground water movement.