[](https://opensource.org/licenses/MIT)
[](https://refinegems.readthedocs.io/en/latest/?badge=latest)
[](https://pypi.org/project/refineGEMs/)
[](https://pypistats.org/packages/refinegems)
[](https://zenodo.org/badge/latestdoi/359867657)
[](https://www.frontiersin.org/articles/10.3389/fbinf.2023.1214074/full)
<p align="center">
<img src="https://github.com/draeger-lab/refinegems/raw/main/docs/source/images/refineGEMs_logo.png" height="200"/>
</p>
# refineGEMs
`refineGEMs` is a python package intended to help with the curation of genome-scale metabolic models (GEMS). </br>
The documentation can be found [here](https://refinegems.readthedocs.io/en/latest/).
## Table of contents
1. [Overview](#overview)
2. [Installation](#installation)
3. [How to cite](#how-to-cite)
4. [Repositories using refineGEMs](#repositories-using-refinegems)
## Overview
Currently `refineGEMs` can be used for the investigation of a GEM, it can complete the following tasks:
- loading GEMs with `COBRApy` and `libSBML`
- report number of metabolites, reactions and genes
- report orphaned, deadends and disconnected metabolites
- report mass and charge unbalanced reactions
- report [Memote](https://memote.readthedocs.io/en/latest/index.html) score
- compare the genes present in the model to the genes found in:
- the [KEGG](https://www.genome.jp/kegg/kegg1.html) Database (Note: This requires the GFF file and the KEGG identifier of your organism.)
- Or the [BioCyc](https://biocyc.org) Database (Note: This requires that a database entry for your organism exists in BioCyc.)
- compare the charges and masses of the metabolites present in the model to the charges and masses denoted in the [ModelSEED](https://modelseed.org/) Database.
Other applications of `refineGEMs` to curate a given model include:
- The correction of a model created with [CarveMe](https://github.com/cdanielmachado/carveme) v1.5.1 or v1.5.2 (for example moving all relevant information from the notes to the annotation field or automatically annotating the GeneProduct section of the model with the respective NCBI gene/protein identifiers from the GeneProduct identifiers),
- The addition of [KEGG](https://www.genome.jp/kegg/kegg1.html) Pathways as Groups (using the [libSBML](https://synonym.caltech.edu/software/libsbml/5.18.0/docs/formatted/python-api/classlibsbml_1_1_groups_model_plugin.html) Groups Plugin),
- Updating the SBO-Term annotations based on [SBOannotator](https://github.com/draeger-lab/SBOannotator),
- Updating the annotation of metabolites and extending the model with reactions (for the purpose of filling gaps) based on a table filled by the user `data/manual_annotations.xlsx` (Note: This only works when the structure of the [example Excel file](https://github.com/draeger-lab/refinegems/blob/5eac900d9848b5ae5faf0055db72a986e7ba64e8/data/manual_curation.xlsx) is used.),
- And extending the model with all information surrounding reactions including the corresponding GeneProducts and metabolites by filling in the table `data/modelName_gapfill_analysis_date_example.xlsx` (Note: This also only works when the structure of the [example Excel file](https://github.com/draeger-lab/refinegems/blob/5eac900d9848b5ae5faf0055db72a986e7ba64e8/data/modelName_gapfill_analysis_date_example.xlsx) is used).
## Installation
You can install `refineGEMs` via pip:
```bash
pip install refineGEMs
```
or to a local conda environment where `refineGEMs` is distributed via this GitHub repository and all dependencies are denoted in the `setup.py` file:
```bash
# clone or pull the latest source code
git clone https://github.com/draeger-lab/refinegems.git
cd refinegems
conda create -n <EnvName> python=3.9
conda activate <EnvName>
# check that pip comes from <EnvName>
which pip
pip install .
```
## How to cite
When using `refineGEMs`, please cite the latest publication:
Famke Bäuerle, Gwendolyn O. Döbel, Laura Camus, Simon Heilbronner, and Andreas Dräger.
Genome-scale metabolic models consistently predict in vitro characteristics of Corynebacterium
striatum. Front. Bioinform., oct 2023. [doi:10.3389/fbinf.2023.1214074](https://doi.org/10.3389/fbinf.2023.1214074).
## Repositories using refineGEMs
- [C_striatum_GEMs](https://github.com/draeger-lab/C_striatum_GEMs)
- draeger-lab/Shaemolyticus - `private`
- draeger-lab/Ssanguinis - `private`
Raw data
{
"_id": null,
"home_page": null,
"name": "refineGEMs",
"maintainer": "Tobias Fehrenbach, Carolin Brune",
"docs_url": null,
"requires_python": "<3.11,>=3.9",
"maintainer_email": null,
"keywords": "Systems Biology, GEM, Metabolic Modelling, Python Package",
"author": "Gwendolyn O. D\u00f6bel",
"author_email": "Famke Baeuerle <famke.baeuerle@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/f1/6d/29389be0a1bea23493abe631f2508e0ae51ecf3cfb5137174d824d440d3b/refinegems-1.5.0.tar.gz",
"platform": null,
"description": "[](https://opensource.org/licenses/MIT)\n\n[](https://refinegems.readthedocs.io/en/latest/?badge=latest)\n\n\n\n\n[](https://pypi.org/project/refineGEMs/)\n\n[](https://pypistats.org/packages/refinegems) \n[](https://zenodo.org/badge/latestdoi/359867657) \n[](https://www.frontiersin.org/articles/10.3389/fbinf.2023.1214074/full)\n\n<p align=\"center\">\n<img src=\"https://github.com/draeger-lab/refinegems/raw/main/docs/source/images/refineGEMs_logo.png\" height=\"200\"/>\n</p>\n\n# refineGEMs\n`refineGEMs` is a python package intended to help with the curation of genome-scale metabolic models (GEMS). </br>\nThe documentation can be found [here](https://refinegems.readthedocs.io/en/latest/).\n\n## Table of contents\n1. [Overview](#overview)\n2. [Installation](#installation)\n3. [How to cite](#how-to-cite)\n4. [Repositories using refineGEMs](#repositories-using-refinegems)\n\n## Overview\n\nCurrently `refineGEMs` can be used for the investigation of a GEM, it can complete the following tasks:\n\n- loading GEMs with `COBRApy` and `libSBML`\n- report number of metabolites, reactions and genes\n- report orphaned, deadends and disconnected metabolites\n- report mass and charge unbalanced reactions\n- report [Memote](https://memote.readthedocs.io/en/latest/index.html) score\n- compare the genes present in the model to the genes found in:\n - the [KEGG](https://www.genome.jp/kegg/kegg1.html) Database (Note: This requires the GFF file and the KEGG identifier of your organism.)\n - Or the [BioCyc](https://biocyc.org) Database (Note: This requires that a database entry for your organism exists in BioCyc.)\n- compare the charges and masses of the metabolites present in the model to the charges and masses denoted in the [ModelSEED](https://modelseed.org/) Database.\n\nOther applications of `refineGEMs` to curate a given model include: \n\n- The correction of a model created with [CarveMe](https://github.com/cdanielmachado/carveme) v1.5.1 or v1.5.2 (for example moving all relevant information from the notes to the annotation field or automatically annotating the GeneProduct section of the model with the respective NCBI gene/protein identifiers from the GeneProduct identifiers),\n- The addition of [KEGG](https://www.genome.jp/kegg/kegg1.html) Pathways as Groups (using the [libSBML](https://synonym.caltech.edu/software/libsbml/5.18.0/docs/formatted/python-api/classlibsbml_1_1_groups_model_plugin.html) Groups Plugin),\n- Updating the SBO-Term annotations based on [SBOannotator](https://github.com/draeger-lab/SBOannotator),\n- Updating the annotation of metabolites and extending the model with reactions (for the purpose of filling gaps) based on a table filled by the user `data/manual_annotations.xlsx` (Note: This only works when the structure of the [example Excel file](https://github.com/draeger-lab/refinegems/blob/5eac900d9848b5ae5faf0055db72a986e7ba64e8/data/manual_curation.xlsx) is used.),\n- And extending the model with all information surrounding reactions including the corresponding GeneProducts and metabolites by filling in the table `data/modelName_gapfill_analysis_date_example.xlsx` (Note: This also only works when the structure of the [example Excel file](https://github.com/draeger-lab/refinegems/blob/5eac900d9848b5ae5faf0055db72a986e7ba64e8/data/modelName_gapfill_analysis_date_example.xlsx) is used).\n\n## Installation\n\nYou can install `refineGEMs` via pip:\n\n```bash\npip install refineGEMs\n\n```\n\nor to a local conda environment where `refineGEMs` is distributed via this GitHub repository and all dependencies are denoted in the `setup.py` file:\n\n```bash\n# clone or pull the latest source code\ngit clone https://github.com/draeger-lab/refinegems.git\ncd refinegems\n\nconda create -n <EnvName> python=3.9\n\nconda activate <EnvName>\n\n# check that pip comes from <EnvName>\nwhich pip\n\npip install .\n\n```\n\n## How to cite\nWhen using `refineGEMs`, please cite the latest publication:\n\nFamke B\u00e4uerle, Gwendolyn O. D\u00f6bel, Laura Camus, Simon Heilbronner, and Andreas Dr\u00e4ger. \nGenome-scale metabolic models consistently predict in vitro characteristics of Corynebacterium\nstriatum. Front. Bioinform., oct 2023. [doi:10.3389/fbinf.2023.1214074](https://doi.org/10.3389/fbinf.2023.1214074).\n\n## Repositories using refineGEMs\n- [C_striatum_GEMs](https://github.com/draeger-lab/C_striatum_GEMs)\n- draeger-lab/Shaemolyticus - `private`\n- draeger-lab/Ssanguinis - `private`\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "refineGEMs: a python package intended to help with the curation of genome-scale metabolic models (GEMS)",
"version": "1.5.0",
"project_urls": {
"documentation": "https://refinegems.readthedocs.io/en/latest/",
"homepage": "https://github.com/draeger-lab/refinegems"
},
"split_keywords": [
"systems biology",
" gem",
" metabolic modelling",
" python package"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8bbf457db957a5859431d67a2400afc51efdf185831663f7f2a234ff61a2d587",
"md5": "d5a0c67c2439c2978966052761480a32",
"sha256": "8b5f929034770ce25142384f290648b2c151d584eff22cf6329ef3df613a544c"
},
"downloads": -1,
"filename": "refineGEMs-1.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d5a0c67c2439c2978966052761480a32",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.11,>=3.9",
"size": 7654550,
"upload_time": "2024-08-27T06:21:53",
"upload_time_iso_8601": "2024-08-27T06:21:53.981335Z",
"url": "https://files.pythonhosted.org/packages/8b/bf/457db957a5859431d67a2400afc51efdf185831663f7f2a234ff61a2d587/refineGEMs-1.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f16d29389be0a1bea23493abe631f2508e0ae51ecf3cfb5137174d824d440d3b",
"md5": "b05e7682010abfe53d98c1635fe0a6f1",
"sha256": "9f120197a8d749c81ab969b6d3a272d1dd626e458c20d860eed6ddd88838cd0f"
},
"downloads": -1,
"filename": "refinegems-1.5.0.tar.gz",
"has_sig": false,
"md5_digest": "b05e7682010abfe53d98c1635fe0a6f1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.11,>=3.9",
"size": 7586413,
"upload_time": "2024-08-27T06:21:56",
"upload_time_iso_8601": "2024-08-27T06:21:56.392207Z",
"url": "https://files.pythonhosted.org/packages/f1/6d/29389be0a1bea23493abe631f2508e0ae51ecf3cfb5137174d824d440d3b/refinegems-1.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-27 06:21:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "draeger-lab",
"github_project": "refinegems",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "refinegems"
}
JSON
