# eQuilibrator - a thermodynamics calculator for biochemical reactions
[](https://badge.fury.io/py/equilibrator-api)
[](https://anaconda.org/conda-forge/equilibrator-api)
[](https://www.python.org/downloads)
[](https://mit-license.org/)
[](https://gitlab.com/elad.noor/equilibrator-api/commits/develop)
[](https://codecov.io/gl/equilibrator/equilibrator-api)
[](https://groups.google.com/g/equilibrator-users)
[](https://equilibrator.readthedocs.io/en/latest/?badge=latest)
## 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](https://equilibrator.readthedocs.io/en/latest/index.html).
If your list of reactions is very short, we recommend trying our
website called [eQuilibrator](http://equilibrator.weizmann.ac.il/) 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](https://gitlab.com/equilibrator/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](http://dx.doi.org/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.
```python
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)}")
```
Raw data
{
"_id": null,
"home_page": "",
"name": "equilibrator-api",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "component contribution,Gibbs energy,biochemical reaction,eQuilibrator",
"author": "",
"author_email": "Elad Noor <elad.noor@weizmann.ac.il>, \"Moritz E. Beber\" <midnighter@posteo.net>",
"download_url": "https://files.pythonhosted.org/packages/ad/f3/c0cb81a088c43ccc7b935c9881fdc4708f8294e5c125b865418b3a0e49d2/equilibrator-api-0.6.0.tar.gz",
"platform": null,
"description": "# eQuilibrator - a thermodynamics calculator for biochemical reactions\n\n[](https://badge.fury.io/py/equilibrator-api)\n[](https://anaconda.org/conda-forge/equilibrator-api)\n[](https://www.python.org/downloads)\n[](https://mit-license.org/)\n\n[](https://gitlab.com/elad.noor/equilibrator-api/commits/develop)\n[](https://codecov.io/gl/equilibrator/equilibrator-api)\n[](https://groups.google.com/g/equilibrator-users)\n[](https://equilibrator.readthedocs.io/en/latest/?badge=latest)\n\n\n## What is `equilibrator-api`?\n\n`equilibrator-api` is a Python package for obtaining estimates of reactions Gibbs energies.\nIt is mainly meant for biologists/bioengineers with basic programming skills that\nwork on metabolism and want to easily add thermodynamic data to their models.\n\nThe documentation is browseable online at\n[readthedocs](https://equilibrator.readthedocs.io/en/latest/index.html).\n\nIf your list of reactions is very short, we recommend trying our\nwebsite called [eQuilibrator](http://equilibrator.weizmann.ac.il/) before spending\nthe time necessary for learning how to use `equilibrator-api`.\n\nThe main advantages of `equilibrator-api` are:\n\n* Batch mode: can be used for large reaction datasets (even more than 1000 reactions)\n* Does not require a network connection (except during installation and initialization)\n* Works with standard compound identifiers (such as ChEBI, KEGG, BiGG and MetaNetX) for more than 500,000 compounds\n\nTo access more advanced features, such as adding new compounds that are not\namong the 500,000 currently in the MetaNetX database, try using our \n[equilibrator-assets](https://gitlab.com/equilibrator/equilibrator-assets)\npackage.\n\n## Cite us\n\nIf you plan to use results from `equilibrator-api` in a scientific publication,\nplease cite our paper:\n\nM. E. Beber, M. G. Gollub, D. Mozaffari, K. M. Shebek, A. I. Flamholz, R. Milo, and E. Noor,\n*eQuilibrator 3.0: a database solution for thermodynamic constant estimation*\nNucleic Acids Research (2021), [DOI:10.1093/nar/gkab1106](http://dx.doi.org/10.1093/nar/gkab1106)\n\n## A very simple example\n\nNote that creating a `ComponentContribution` object for the first time after\ninstallation, starts an initialization step which downloads ~1.5 GBytes of data\nto your computer. It can take more than an hour (depending on the connection speed).\nNote that the initialization might not work inside a Jupyter notebook environment - \nin that case you should try running it in a standard python shell first and then\nrun the Jupyter notebook.\n\n```python\nfrom equilibrator_api import ComponentContribution\ncc = ComponentContribution()\nrxn = cc.parse_reaction_formula(\"kegg:C00002 + kegg:C00001 = kegg:C00008 + kegg:C00009\")\nprint(f\"\u0394G'0 = {cc.standard_dg_prime(rxn)}\")\n```\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Calculation of standard thermodynamic potentials of biochemical reactions",
"version": "0.6.0",
"project_urls": {
"documentation": "https://equilibrator.readthedocs.io/en/latest/",
"repository": "https://gitlab.com/equilibrator/equilibrator-api/"
},
"split_keywords": [
"component contribution",
"gibbs energy",
"biochemical reaction",
"equilibrator"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a728b8d7c2cddda52a261a65fb8d642dad846b0c683a979a532ab4e42ce308dc",
"md5": "2ef3321fa73a45007c813916f31a8928",
"sha256": "3fa1665e65c6ac4e67c54bd798effd3f3e2c1d0511ab8ef1c08e9d3a8ec38ce6"
},
"downloads": -1,
"filename": "equilibrator_api-0.6.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "2ef3321fa73a45007c813916f31a8928",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.9",
"size": 40528,
"upload_time": "2024-01-28T09:19:40",
"upload_time_iso_8601": "2024-01-28T09:19:40.629251Z",
"url": "https://files.pythonhosted.org/packages/a7/28/b8d7c2cddda52a261a65fb8d642dad846b0c683a979a532ab4e42ce308dc/equilibrator_api-0.6.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "adf3c0cb81a088c43ccc7b935c9881fdc4708f8294e5c125b865418b3a0e49d2",
"md5": "23816587308b16c54b00dfe85243305d",
"sha256": "7c1d0a2029b0e07f10956f61df191768409729152eb570bb77a9d8ed946a822d"
},
"downloads": -1,
"filename": "equilibrator-api-0.6.0.tar.gz",
"has_sig": false,
"md5_digest": "23816587308b16c54b00dfe85243305d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 53395,
"upload_time": "2024-01-28T09:19:56",
"upload_time_iso_8601": "2024-01-28T09:19:56.909166Z",
"url": "https://files.pythonhosted.org/packages/ad/f3/c0cb81a088c43ccc7b935c9881fdc4708f8294e5c125b865418b3a0e49d2/equilibrator-api-0.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-28 09:19:56",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "equilibrator",
"gitlab_project": "equilibrator-api",
"lcname": "equilibrator-api"
}
JSON