Skip to main content

Estimate thermodynamic properties of aqueous metal complexes with monovalent ligands.

Project description

The Complicator

Code Authors: Grayson Boyer, Everett Shock Data Compilers: GEOPIG Lab, Apar Prasad

This is a Python package for estimating standard state thermodynamic properties and Helgeson-Kirkham-Flowers (HKF) equation of state parameters for aqueous metal complexes with monovalent ligands using published methods from Shock and Koretsky 1995.

Installation

This package can be installed through PyPI with: pip install Complicator

Usage

The best way to learn about the Complicator is through the WORM Portal (worm-portal.asu.edu). Check out Jupyter notebook demo 4-2-1 in the WORM Library available when you log in.

What follows is a brief example of how the Complicator can be used.

Supply a dataframe containing names of metals, ligands, stability constants for the first through fourth association at 25 °C, and optionally, standard state entropies of association for the first through fourth association complex. An example is assigned to the variable df_input in the example below.

import pandas as pd
from Complicator import complicate

df_input = pd.DataFrame({
        "Metal":["Ag+", "Al+3"],
        "Ligand":["OH-", "OH-"],
        "BETA_1":[2, 9.03], # stability constant for the first association complex
        "BETA_2":[3.97, 17.6], # second stability constant
        "BETA_3":[float('NaN'), 26.4], # third stability constant
        "BETA_4":[float('NaN'), 33.8], # fourth stability constant
        "Sass_1":[float('NaN'), 36.5], # entropy of association for the first complex (cal/mol/K)
        })

df_out, _, _, _ = complicate(df_in=df_input)

df_out

The output is a dataframe containing estimated thermodynamic properties, parameters for the revised Helgeson Kirkham Flowers (HKF) equation of state, and more. The format of the output is explained in more detail here. This Water-Organic-Rock-Microbe (WORM) database format is designed to be compatible with the free and open source online geochemical modeling platform WORM Portal. Estimated thermodynamic properties of complexes from the Complicator can be used in conjunction with the rest of the WORM database to:

  • calculate properties of reactions and create activity or predominance diagrams.
  • expand the number of aqueous complexes available in geochemical speciation (equilibration) and mass transfer calculations.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Complicator-0.1.2.tar.gz (138.0 kB view hashes)

Uploaded Source

Built Distribution

Complicator-0.1.2-py3-none-any.whl (138.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page