pyGSFLOW is a python package to Create, Read, Write, Edit, and Visualize GSFLOW models.


Ipython notebook example problems can be found in the examples directory.


The pygsflow repository can be installed using pip.
Open a command prompt or anaconda prompt terminal and type:

pip install

pygsflow is now installed

Alternatively the user can download a copy of the repository, open a command prompt or anaconda promt terminal, cd into the trunk directory and type:

pip install .


Ayman Alzraiee, Joshua Larsen, Rich Niswonger


The code is in active development and although there is a testing infrastructure set up we cannot catch all the software bugs without the help of users. If you find a bug or have an issue, please report it by opening a new issue. You can open a new issue by clicking the issues tab near the top of the page.

Project History

This project is a refinement and continuation of the original pygsflow repository at:


This software is preliminary or provisional and is subject to revision. It is being provided to meet the need for timely best science. The software has not received final approval by the U.S. Geological Survey (USGS). No warranty, expressed or implied, is made by the USGS or the U.S. Government as to the functionality of the software and related material nor shall the fact of release constitute any such warranty. The software is provided on the condition that neither the USGS nor the U.S. Government shall be held liable for any damages resulting from the authorized or unauthorized use of the software