PhreeqPy - Python Tools for PHREEQC


PhreeqPy is Open Source software and provides Python tools to work with PHREEQC.

Currently it provides access to the new IPhreeqc interface without the need to run a COM server and therefore also works on non-Windows systems. IPhreeqc is described in more detail in this publication.

Please let us know what you do with PhreeqPy or if things do not work as expected. There is a mailing list for PhreeqPy. Please subscribe to get your questions about PhreeqPy answered.

Download latest version of this documentation as PDF

License: BSD


Pythons (tested): Python 2.6, 2.7, 3.3, 3.4, 3.5, 3.6, PyPy

Pythons (untested but should work since using ctypes): IronPython, Jython 2.7

Platforms: Unix/Posix and Windows

PyPI package name: phreeqpy

1.) Installation options:

pip install -U phreeqpy

2.) Download:

wget wget
tar -xzvf phreeqpy-0.2.0.tar.gz
cd phreeqpy-0.2.0
sudo python setup install

You need an IPhreeqc shared libray for your operating system. PhreeqPy comes with shared libraries for 32-bit Windows, 32-bit Linux and 64-bit Mac OS X. More shared libraries for different platforms will come with following releases.

You may download an appropriate library from here:

For example for Linux:

tar -xzvf iphreeqc-2.18.4-6386.tar.gz
cd iphreeqc-2.18.4-6386
make check
sudo make install

Then either use the full path to the shared libray when making an instance of phreeqc_dll.IPhreeqc

phreeqc = phreeqpy.iphreeqc.phreeqc_dll.IPhreeqc('/full/path/to/')

or copy the shared object into phreeqpy/iphreeqc replacing the existing one. For example:

sudo cp /usr/local/lib/  /path/to/site-pacges/PhreeqPy-0.2.0-py2.7.egg/phreeqpy/iphreeqc/

Benchmark Test Comparing PhreeqPy to External Processes, COM and C++

This publication demonstrates how PhreeqPy can be used for reactive transport modeling.

Müller M., Parkhurst D.L., Charlton S.R. (2011) Programming PHREEQC Calculations with C++ and Python - A Comparative Study , In: Maxwell R., Poeter E., Hill M., Zheng C. (2011) MODFLOW and More 2011 - Integrated Hydrological Modeling, Proceedings, pp. 632 - 636.