PyTOUGH (Python TOUGH) is a Python library for simplifying, extending and automating the use of the TOUGH2 subsurface fluid and heat flow simulator. Using PyTOUGH, it is possible to automate the creation and editing of TOUGH2 model grids and data files, and the analysis and display of model simulation results, using Python scripts.

From version 1.6.0, PyTOUGH can be installed via the pip Python package installer:

pip install PyTOUGH

You can also install a particular version of PyTOUGH, e.g. to install version 1.6.0:

pip install PyTOUGH==1.6.0

To uninstall PyTOUGH:

pip uninstall PyTOUGH

To install the testing branch, to get the most recent changes being tested for the next stable release:

pip install git+https://github.com/acroucher/PyTOUGH.git@testing

For more detailed information on PyTOUGH, consult the user guide (html, or you can download PDF or Epub versions) and the PyTOUGH wiki, which has links to published articles on PyTOUGH.

The latest stable version is 1.6.3, which has:

• three bug fixes in the t2data json() method, for improved conversion of TOUGH2 models to Waiwera

• various other minor updates