Skip to main content

eQuilibrator - a thermodynamics calculator for biochemical reactions

PyPI version Anaconda-Server Badge Python version MIT license

pipeline status codecov Join our Google group Documentation Status

What is equilibrator-api?

equilibrator-api is a Python package for obtaining estimates of reactions Gibbs energies. It is mainly meant for biologists/bioengineers with basic programming skills that work on metabolism and want to easily add thermodynamic data to their models.

The documentation is browseable online at readthedocs.

If your list of reactions is very short, we recommend trying our website called eQuilibrator before spending the time necessary for learning how to use equilibrator-api.

The main advantages of equilibrator-api are:

  • Batch mode: can be used for large reaction datasets (even more than 1000 reactions)
  • Does not require a network connection (except during installation and initialization)
  • Works with standard compound identifiers (such as ChEBI, KEGG, BiGG and MetaNetX) for more than 500,000 compounds

To access more advanced features, such as adding new compounds that are not among the 500,000 currently in the MetaNetX database, try using our equilibrator-assets package.

Cite us

If you plan to use results from equilibrator-api in a scientific publication, please cite our paper:

M. E. Beber, M. G. Gollub, D. Mozaffari, K. M. Shebek, A. I. Flamholz, R. Milo, and E. Noor, eQuilibrator 3.0: a database solution for thermodynamic constant estimation Nucleic Acids Research (2021), DOI:10.1093/nar/gkab1106

A very simple example

Note that creating a ComponentContribution object for the first time after installation, starts an initialization step which downloads ~1.5 GBytes of data to your computer. It can take more than an hour (depending on the connection speed). Note that the initialization might not work inside a Jupyter notebook environment - in that case you should try running it in a standard python shell first and then run the Jupyter notebook.

from equilibrator_api import ComponentContribution
cc = ComponentContribution()
rxn = cc.parse_reaction_formula("kegg:C00002 + kegg:C00001 = kegg:C00008 + kegg:C00009")
print(f"ΔG'0 = {cc.standard_dg_prime(rxn)}")

Metadata

Release files for equilibrator-api 0.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for equilibrator-api 0.8.0
File Size Uploaded
equilibrator_api-0.8.0.tar.gz 34.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for equilibrator-api 0.8.0
File Interpreter ABI Platform
equilibrator_api-0.8.0-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 74.8 kB

Release files / equilibrator_api-0.8.0.tar.gz

Download URL equilibrator_api-0.8.0.tar.gz
Size 34.4 kB
Tags Source
SHA-256 checksum
How to use checksums
53ce1c81649ee135a007dadfd1c0275701d52ff8c6a868ff96897e023ea9ffa5
BLAKE2b-256 checksum
How to use checksums
6013a2c7d68c074df009f5de49ce8d6132092dda4df8351e89429c16270a205a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / equilibrator_api-0.8.0-py2.py3-none-any.whl

Download URL equilibrator_api-0.8.0-py2.py3-none-any.whl
Size 40.4 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
d1fc126939338e4f14f4488c7d5cead468ffde1001c7ff1366349c50d5254e26
BLAKE2b-256 checksum
How to use checksums
eef49ccc67eed1ecb0ddb6d31f4a8b73bbc43ac8350a594f1f346d0f234a45d7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release history Release notifications | RSS feed

0.8.1

2 release files

This release

0.8.0 This release

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.0

2 release files

0.1.26

2 release files

0.1.11

1 release file

0.1.8

2 release files

0.1.7

3 release files

0.1.6

3 release files

0.1.5

3 release files

0.1.4

3 release files

0.1.3

3 release files

0.1.1

3 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page