superwell.py: runs the superwell model to simulate groundwater extraction and cost estimation.superwell_deepening.py: main superwell script that includes well deepening.superwell_deepening_sample.py: Customized version ofsuperwell_deepeningto run sampled inputs to facilitate quick analysis and testing.processing.py: plots a few model results as diagnostics
Adjust settings in params.csv within the inputs/ folder to match your scenario requirements. This file controls various model parameters like Country_filter, Basin_filter, Gridcell_filter, Ponded_Depth, Recharge_flag, and Depletion_Limit.
Before running the superwell scripts, ensure that Python, key libraries, and any other model-specific dependencies are installed.
To execute the model, run the appropriate script from the command line or an integrated development environment (IDE). For example, to run the deepening version, you would use:
python superwell_deepening.pyThis script will process the input data and populate results in the outputs/ folder.
Be aware that changes to settings in params.csv, such as
Country_filterandGridcell_filter, will automatically determine the naming of output files. Ensure that previously generated output files are renamed or moved from theoutputs/folder. before re-running the model to prevent overwriting.
Key model documentation & primary citation:
Niazi, H., Ferencz, S., Graham, N., Yoon, J., Wild, T., Hejazi, M., Watson, D., & Vernon, C. (2024; In-prep). Long-term Hydro-economic Analysis Tool for Evaluating Global Groundwater Cost and Supply: Superwell v1.0. Geoscientific Model Development.