Skip to content
/ pytzer Public

The Pitzer model for chemical activities and equilibria in aqueous solutions in Python

License

Notifications You must be signed in to change notification settings

mvdh7/pytzer

Repository files navigation

Pytzer

Tests Coverage pypi badge DOI License: GPL v3 Code style: black

Pytzer is a Python implementation of the Pitzer model for chemical activities in aqueous solutions [P91] plus solvers to determine the equilibrium state of the system.

Pytzer is in beta! Use at your own peril.

Installation

Due to its dependency on JAX, Pytzer can only be installed on Unix systems, although it does work on Windows via WSL.

For general use

Install with pip:

pip install pytzer

Note that you should also install the dependencies (especially NumPy) using pip, not conda, for best performance. This happens automatically with the above command if the dependencies are not already installed.

Once installed, you will need to set the environment variable JAX_ENABLE_X64=True. For example, using conda:

conda env config vars set JAX_ENABLE_X64=True

Documentation

A work in progress at mvdh.xyz/pytzer.

Citation

Pytzer is maintained by Dr Matthew P. Humphreys at the NIOZ Royal Netherlands Institute for Sea Research (Texel, the Netherlands).

For now, the appropriate citation is:

Humphreys, Matthew P. and Schiller, Abigail J. (2023). Pytzer: the Pitzer model for chemical activities and equilibria in aqueous solutions in Python (beta). Zenodo. doi:10.5281/zenodo.2637914.

Please report which version of Pytzer you are using. You can find this in Python with:

import pytzer as pz
pz.hello()