Superwell v1.1

Physics-based hydro-economic model for global groundwater cost and supply estimation

Global Scale

72,548 grid cells worldwide

Multi-temporal

Years to centuries analysis

Physics-Based

Hydrogeological principles

Economic Integration

Cost-supply relationships

Superwell Conceptual Framework

Hydro-Economic Framework

Superwell integrates hydrogeological physics with economic modeling to estimate groundwater extraction costs. The model combines aquifer properties, well hydraulics, and energy economics to provide spatially-explicit cost-supply relationships across global groundwater basins. Superwell calculates how much groundwater can be extracted and at what cost, using detailed maps and data of the Earth's properties. Through these estimates, and by using them with other models, Superwell facilitates exploration of coupled human–environmental system challenges, such as future water supply sustainability or multi-sectoral energy–water–land feedbacks.

Explore Dashboard

Interactive visualizations and data analysis tools

Read the Science

Published in Geoscientific Model Development & Nature Sustainability

View Documentation

Installation guides, API reference, and examples

Interactive Dashboard

Total Scenarios -
Grid Cells 72,548
Variables -
Time Range -

Select variables and click "Update Visualization" to begin

Data Explorer

Rows: 0

Click "Load Sample" or "Load Full Dataset" to view data

Rows: 0

Click "Load Sample" or "Load Full Dataset" to view data

Load data to see statistics

Advanced Visualization

Configuration

Configure and generate custom visualizations

Documentation

Quick Start

Get up and running with Superwell in minutes

git clone https://github.com/JGCRI/superwell.git
cd superwell/python
pip install -r requirements.txt
python superwell_deepening.py

Model Parameters

Transmissivity (T) Aquifer hydraulic conductivity
Storativity (S) Water storage coefficient
Well Depth Extraction depth and radius
Recharge Rate Natural aquifer replenishment
Economic Factors Discount rate, electricity cost

Data Format

Required CSV columns for model inputs:

lat, lon Geographic coordinates
transmissivity, storativity Aquifer properties
recharge_rate, depth_to_water Water levels
electricity_rate, discount_rate Economic factors

Citation

Niazi, H., Ferencz, S. B., Graham, N. T., Yoon, J., Wild, T. B., Hejazi, M., Watson, D. J., & Vernon, C. R. (2025).

Long-term hydro-economic analysis tool for evaluating global groundwater cost and supply: Superwell v1.1.

Geoscientific Model Development, 18(5), 1737-1767.

View Publication
Get Superwell $ git clone https://github.com/JGCRI/superwell.git