Teach Me How to PyCap : A High‐Capacity Well Decision Support Tool Using Analytical Solutions in Python
Open Access
- 25 January 2026
- journal article
- Published by Wiley in Groundwater
- Vol. 64 (2) , 223-234
Abstract
Regulatory agencies in humid temperate environments rely on timely evaluations of streamflow depletion and drawdown to protect aquatic ecosystems and existing water users. Numerical models offer detailed insights, but their complexity and time demands often preclude their practical use in rapid decision‐making. We present pycap‐dss, an open‐source Python package that implements a suite of analytical solutions for estimating streamflow depletion and drawdown. The tool supports superposition of multiple wells and time‐varying pumping, enabling cumulative impact assessments in situations with multiple wells and streams. The software is modular and extensible, allowing users to interchange solutions or add new analytical methods. A YAML‐based configuration supports batch processing of multiple wells, and an optional AnalysisProject class facilitates integration with regulatory workflows. Rigorous unit and regression testing ensures computational reliability, and continuous integration supports ongoing development. We demonstrate deterministic examples of drawdown where multiple solutions are readily compared and streamflow depletion with multiple wells in the Central Sands region of Wisconsin. We also show the value of Monte Carlo analyses of streamflow depletion in the same Central Sands example, leveraging computational efficiency to evaluate the uncertainty of individual and cumulative streamflow depletion calculations from over 200 high‐capacity wells.Keywords
Funding Information
- Wisconsin Department of Natural Resources
- U.S. Geological Survey
This publication has 13 references indexed in Scilit:
- Testing and applying analytical depletion functions for multiple pumping wells in two hydrogeological landscapesJournal of Hydrology, 2025
- Rapid and Accurate Estimates of Streamflow Depletion Caused by Groundwater Pumping Using Analytical Depletion FunctionsWater Resources Research, 2019
- Capture Versus Capture Zones: Clarifying Terminology Related to Sources of Water to WellsGroundwater, 2018
- Depletion Mapping and Constrained Optimization to Support Managing Groundwater ExtractionGroundwater, 2017
- A python framework for environmental model uncertainty analysisEnvironmental Modelling & Software, 2016
- Pro Git2014
- Science as a fundamental framework for shaping policy discussions regarding the use of groundwater in the State of Michigan: a case studyWater Policy, 2011
- Floods, channel change, and the hyporheic zoneWater Resources Research, 1999
- River depletion resulting from pumping a well near a riverEOS, Transactions American Geophysical Union, 1954
- The relation between the lowering of the Piezometric surface and the rate and duration of discharge of a well using ground‐water storageEOS, Transactions American Geophysical Union, 1935