# SBOannotator
<img align="right" src="SBOannotator_logo.png" alt="drawing" width="200"/>
**SBOannotator: a Python tool for the automated assignment of Systems Biology Ontology terms**
[![License (LGPL version 3)](https://img.shields.io/badge/license-LGPLv3.0-blue.svg?style=plastic)](http://opensource.org/licenses/LGPL-3.0)
[![Latest version](https://img.shields.io/badge/Latest_version-0.9-brightgreen.svg?style=plastic)](https://github.com/draeger-lab/SBOannotator/releases/)
![Code Size](https://img.shields.io/github/languages/code-size/draeger-lab/SBOannotator.svg?style=plastic)
[![PyPI version](https://badge.fury.io/py/SBOannotator.svg)](https://badge.fury.io/py/SBOannotator)
![PyPI - Format](https://img.shields.io/pypi/format/SBOannotator)
[![PyPI downloads](https://img.shields.io/pypi/dm/SBOannotator.svg)](https://pypistats.org/packages/SBOannotator)
[![DOI](https://img.shields.io/badge/DOI-10.1093%2Fbioinformatics%2Fbtad437-blue.svg?style=plastic)](https://doi.org/10.1093/bioinformatics/btad437)
*Developers* : [Nantia Leonidou](https://github.com/NantiaL) & Elisabeth Fritze
___________________________________________________________________________________________________________
### How to cite the SBOannotator?
The SBOannotator is described in this article: https://doi.org/10.1093/bioinformatics/btad437
### Overview
SBOannotator is the first standalone tool that automatically assigns SBO terms to multiple entities of a given SBML model,
The main focus lies on the reactions, as the correct assignment of precise SBO annotations requires their extensive classification.
Our implementation does not consider only top-level terms but examines the functionality of the underlying enzymes to
allocate precise and highly specific ontology terms to biochemical reactions.
Transport reactions are examined separately and are classified based on the mechanism of molecule transport.
Pseudo-reactions that serve modeling purposes are given reasonable terms to distinguish between biomass production and the
import or export of metabolites. Finally, other model entities, such as metabolites and genes, are annotated with appropriate terms.
Including SBO annotations in the models will enhance the reproducibility, usability, and analysis of biochemical networks.
### Web Application
Web application hosted at [TueVis](https://tuevis.cs.uni-tuebingen.de/sboannotator/) is accessible and ready to use at [sbo-annotator-tuevis.cs.uni-tuebingen.de/](https://sbo-annotator-tuevis.cs.uni-tuebingen.de/)
### Installation
```
pip install SBOannotator
```
### Prerequisites
This tool has the following dependencies:
python >=3.8.5
Packages:
* sqlite3
* libsbml
* collections
* requests
* json
* time
### Input data
+ `doc`: an SBML document
+ `model_libsbml`: SBML model of interest
+ `modelType`: type of modelling framework (see below)
+ `modelAnnotated`: True, if model already includes annotations with EC numbers
+ `database_name`: name of imported database, without extension
+ `new_filename`: file name for output model
Types of modelling framework accepted:
- constraint-based
- logical
- continuous
- discrete
- hybrid
- logical
### Outputs
+ `model_libsbml`: Annotated libSBML model
### Usage
To run SBOannotator use the `main.py` script and modify the parameters in the `readSBML` and `sbo_annotator`
functions as wished.
If ERROR occurs, check the current version of Python:
- `python --version'`
- `conda install python>=3.8.5`
### Exemplary models and Results
The folder `models/BiGG_Models` contains all the tested models as they were downloaded from
the BiGG database.
The annotated models after using the SBOannotator are listed in the folder named `models/Annotated_Models`.
Raw data
{
"_id": null,
"home_page": "https://github.com/draeger-lab/SBOannotator",
"name": "SBOannotator",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "SBOannotator, SBO Terms, automated tool",
"author": "Nantia Leonidou, Elisabeth Fritze, Alina Renz, Andreas Dr\u00e4ger",
"author_email": "nantia.leonidou@uni-tuebingen.de",
"download_url": "https://files.pythonhosted.org/packages/31/ca/7f0b0f450bc4fb69f316d95bb270d3a7dc6ff738d6390a035143f9f4e83f/SBOannotator-2.2.2.tar.gz",
"platform": null,
"description": "# SBOannotator\n<img align=\"right\" src=\"SBOannotator_logo.png\" alt=\"drawing\" width=\"200\"/>\n\n**SBOannotator: a Python tool for the automated assignment of Systems Biology Ontology terms**\n\n[![License (LGPL version 3)](https://img.shields.io/badge/license-LGPLv3.0-blue.svg?style=plastic)](http://opensource.org/licenses/LGPL-3.0)\n[![Latest version](https://img.shields.io/badge/Latest_version-0.9-brightgreen.svg?style=plastic)](https://github.com/draeger-lab/SBOannotator/releases/)\n![Code Size](https://img.shields.io/github/languages/code-size/draeger-lab/SBOannotator.svg?style=plastic)\n[![PyPI version](https://badge.fury.io/py/SBOannotator.svg)](https://badge.fury.io/py/SBOannotator)\n![PyPI - Format](https://img.shields.io/pypi/format/SBOannotator)\n[![PyPI downloads](https://img.shields.io/pypi/dm/SBOannotator.svg)](https://pypistats.org/packages/SBOannotator)\n[![DOI](https://img.shields.io/badge/DOI-10.1093%2Fbioinformatics%2Fbtad437-blue.svg?style=plastic)](https://doi.org/10.1093/bioinformatics/btad437)\n\n*Developers* : [Nantia Leonidou](https://github.com/NantiaL) & Elisabeth Fritze\n___________________________________________________________________________________________________________\n\n### How to cite the SBOannotator?\n\nThe SBOannotator is described in this article: https://doi.org/10.1093/bioinformatics/btad437\n\n### Overview\nSBOannotator is the first standalone tool that automatically assigns SBO terms to multiple entities of a given SBML model, \nThe main focus lies on the reactions, as the correct assignment of precise SBO annotations requires their extensive classification. \nOur implementation does not consider only top-level terms but examines the functionality of the underlying enzymes to \nallocate precise and highly specific ontology terms to biochemical reactions. \nTransport reactions are examined separately and are classified based on the mechanism of molecule transport. \nPseudo-reactions that serve modeling purposes are given reasonable terms to distinguish between biomass production and the \nimport or export of metabolites. Finally, other model entities, such as metabolites and genes, are annotated with appropriate terms. \nIncluding SBO annotations in the models will enhance the reproducibility, usability, and analysis of biochemical networks.\n\n### Web Application\nWeb application hosted at [TueVis](https://tuevis.cs.uni-tuebingen.de/sboannotator/) is accessible and ready to use at [sbo-annotator-tuevis.cs.uni-tuebingen.de/](https://sbo-annotator-tuevis.cs.uni-tuebingen.de/)\n\n### Installation\n```\npip install SBOannotator\n```\n\n### Prerequisites\n\nThis tool has the following dependencies:\n\npython >=3.8.5\n\nPackages:\n* sqlite3\n* libsbml\n* collections\n* requests\n* json\n* time\n\n### Input data\n+ `doc`: an SBML document\n+ `model_libsbml`: SBML model of interest\n+ `modelType`: type of modelling framework (see below)\n+ `modelAnnotated`: True, if model already includes annotations with EC numbers\n+ `database_name`: name of imported database, without extension\n+ `new_filename`: file name for output model\n\nTypes of modelling framework accepted:\n- constraint-based\n- logical\n- continuous\n- discrete\n- hybrid\n- logical\n\n### Outputs\n+ `model_libsbml`: Annotated libSBML model\n\n### Usage\nTo run SBOannotator use the `main.py` script and modify the parameters in the `readSBML` and `sbo_annotator` \nfunctions as wished.\n\nIf ERROR occurs, check the current version of Python: \n\n- `python --version'`\n- `conda install python>=3.8.5`\n\n### Exemplary models and Results\nThe folder `models/BiGG_Models` contains all the tested models as they were downloaded from\nthe BiGG database. \nThe annotated models after using the SBOannotator are listed in the folder named `models/Annotated_Models`.\n\n\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "SBOannotator: A Python tool for the automated assignment of Systems Biology Ontology terms",
"version": "2.2.2",
"project_urls": {
"Homepage": "https://github.com/draeger-lab/SBOannotator"
},
"split_keywords": [
"sboannotator",
" sbo terms",
" automated tool"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "31ca7f0b0f450bc4fb69f316d95bb270d3a7dc6ff738d6390a035143f9f4e83f",
"md5": "aa45cfef5fd9f54ec884aa51950e5109",
"sha256": "f043efcb04263e8ecc454f2786b0d47843ce77a3c36032d8c1e243305db15e46"
},
"downloads": -1,
"filename": "SBOannotator-2.2.2.tar.gz",
"has_sig": false,
"md5_digest": "aa45cfef5fd9f54ec884aa51950e5109",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 22075,
"upload_time": "2024-05-03T15:56:14",
"upload_time_iso_8601": "2024-05-03T15:56:14.725876Z",
"url": "https://files.pythonhosted.org/packages/31/ca/7f0b0f450bc4fb69f316d95bb270d3a7dc6ff738d6390a035143f9f4e83f/SBOannotator-2.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-03 15:56:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "draeger-lab",
"github_project": "SBOannotator",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "setuptools",
"specs": [
[
">=",
"58.0.4"
]
]
},
{
"name": "cobra",
"specs": [
[
">=",
"0.22.1"
]
]
},
{
"name": "python-libsbml",
"specs": [
[
">=",
"5.19.0"
]
]
},
{
"name": "pandas",
"specs": [
[
">=",
"2.0.3"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.28.2"
]
]
}
],
"lcname": "sboannotator"
}