<img src="https://github.com/micom-dev/q2-micom/raw/main/docs/assets/logo.png" width="75%">
[](https://github.com/micom-dev/q2-micom/actions/workflows/test_package.yml)
[](https://codecov.io/gh/micom-dev/q2-micom)
[](https://badge.fury.io/py/q2-micom)
A QIIME 2 plugin for MICOM.
## Installation
You will need an existing QIIME 2 environment. Follow the instructions on ([how to install QIIME 2](https://docs.qiime2.org/2024.2/install/native/#install-qiime-2-within-a-conda-environment)) otherwise. `q2-micom` is compatible with all QIIME 2 distributions.
Let's assume that environment was called `qiime2-2024.2` for all further steps.
### Add q2-micom to the QIIME 2 environment
This will be the same step for any supported QIIME 2 version but will vary depending on your operating system
(similar to the normal QIIME 2 installation).
```bash
wget https://raw.githubusercontent.com/micom-dev/q2-micom/main/q2-micom.yml
conda env update -n qiime2-2024.2 -f q2-micom.yml
# OPTIONAL CLEANUP
rm q2-micom-*.yml
```
Finally, you activate your environment.
```bash
conda activate qiime2-2024.2
```
`q2-micom` will now install an open source solver that can be used with MICOM. If you use MICOM
regularly we do recommend to obtain an academic license for CPLEX or Gurobi which will be faster.
### Install a faster solver (recommended but optional)
*CPLEX*
*QIIME 2 versions before 2021.4 are only compatible with CPLEX 12.10 or earlier (later version require at least Python 3.7).*
After registering and downloading the CPLEX studio for your OS unpack it (by running the provided installer) to a directory of your choice (we will assume it's called `ibm`).
Now install the CPLEX python package into your activated environment:
```bash
pip install ibm/cplex/python/3.8/x86-64_linux
```
Substitute `3.8` with the Python version in your QIIME 2 environment, `3.6` for QIIME 2 up to 2021.2 and `3.8` for QIIME 2 2021.4 and newer.
Substitute `x86-64_linux` with the folder corresponding to your system (there will only be one subfolder in that directory).
***Gurobi***
Gurobi can be installed with conda.
```bash
conda install -c gurobi gurobi
```
You will now have to register the installation using your license key.
```bash
grbgetkey YOUR-LICENSE-KEY
```
### Finish your installation
If you installed `q2-micom` in an already existing QIIME 2 environment, update the plugin cache:
```bash
conda activate qiime2-2024.2 # or whatever you called your environment
qiime dev refresh-cache
```
You are now ready to run `q2-micom`!
## Usage
Here is a graphical overview of a `q2-micom` analysis.
<img src="https://github.com/micom-dev/q2-micom/raw/main/docs/assets/overview.png" width="100%">
The best way to get started is to work through the [community tutorial](https://micom-dev.github.io/q2-micom).
## Supported QIIME 2 versions
`q2-micom` is tested against:
1. the current [QIIME 2 version](https://docs.qiime2.org/)
2. the previous version
It should also work with
3. the [development version](https://dev.qiime2.org/latest/)<br>
However, this may occasionally break. Check [here for the current status](https://github.com/micom-dev/q2-micom/actions/workflows/qiime_dev.yml).
## References
MICOM: Metagenome-Scale Modeling To Infer Metabolic Interactions in the Gut Microbiota <br>
Christian Diener, Sean M. Gibbons, Osbaldo Resendis-Antonio <br>
mSystems 5:e00606-19 <br>
https://doi.org/10.1128/mSystems.00606-19
Raw data
{
"_id": null,
"home_page": "https://github.com/micom-dev/q2-micom",
"name": "q2-micom",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "microbiome, modeling, metabolism, community",
"author": "Christian Diener",
"author_email": "mail@cdiener.com,",
"download_url": "https://files.pythonhosted.org/packages/de/ae/27e90ebe531fd3dd04f8904633e4940c99df3d96459e33a67fe50294b56c/q2-micom-0.16.0.tar.gz",
"platform": null,
"description": "<img src=\"https://github.com/micom-dev/q2-micom/raw/main/docs/assets/logo.png\" width=\"75%\">\n\n[](https://github.com/micom-dev/q2-micom/actions/workflows/test_package.yml)\n[](https://codecov.io/gh/micom-dev/q2-micom)\n[](https://badge.fury.io/py/q2-micom)\n\n\nA QIIME 2 plugin for MICOM.\n\n## Installation\n\nYou will need an existing QIIME 2 environment. Follow the instructions on ([how to install QIIME 2](https://docs.qiime2.org/2024.2/install/native/#install-qiime-2-within-a-conda-environment)) otherwise. `q2-micom` is compatible with all QIIME 2 distributions.\nLet's assume that environment was called `qiime2-2024.2` for all further steps.\n\n### Add q2-micom to the QIIME 2 environment\n\nThis will be the same step for any supported QIIME 2 version but will vary depending on your operating system\n(similar to the normal QIIME 2 installation).\n\n```bash\nwget https://raw.githubusercontent.com/micom-dev/q2-micom/main/q2-micom.yml\nconda env update -n qiime2-2024.2 -f q2-micom.yml\n# OPTIONAL CLEANUP\nrm q2-micom-*.yml\n```\n\nFinally, you activate your environment.\n\n```bash\nconda activate qiime2-2024.2\n```\n\n`q2-micom` will now install an open source solver that can be used with MICOM. If you use MICOM\nregularly we do recommend to obtain an academic license for CPLEX or Gurobi which will be faster.\n\n### Install a faster solver (recommended but optional)\n\n*CPLEX*\n\n*QIIME 2 versions before 2021.4 are only compatible with CPLEX 12.10 or earlier (later version require at least Python 3.7).*\n\nAfter registering and downloading the CPLEX studio for your OS unpack it (by running the provided installer) to a directory of your choice (we will assume it's called `ibm`).\n\nNow install the CPLEX python package into your activated environment:\n\n```bash\npip install ibm/cplex/python/3.8/x86-64_linux\n```\n\nSubstitute `3.8` with the Python version in your QIIME 2 environment, `3.6` for QIIME 2 up to 2021.2 and `3.8` for QIIME 2 2021.4 and newer.\nSubstitute `x86-64_linux` with the folder corresponding to your system (there will only be one subfolder in that directory).\n\n***Gurobi***\n\nGurobi can be installed with conda.\n\n```bash\nconda install -c gurobi gurobi\n```\n\nYou will now have to register the installation using your license key.\n\n```bash\ngrbgetkey YOUR-LICENSE-KEY\n```\n\n### Finish your installation\n\nIf you installed `q2-micom` in an already existing QIIME 2 environment, update the plugin cache:\n\n```bash\nconda activate qiime2-2024.2 # or whatever you called your environment\nqiime dev refresh-cache\n```\n\nYou are now ready to run `q2-micom`!\n\n## Usage\n\nHere is a graphical overview of a `q2-micom` analysis.\n\n<img src=\"https://github.com/micom-dev/q2-micom/raw/main/docs/assets/overview.png\" width=\"100%\">\n\nThe best way to get started is to work through the [community tutorial](https://micom-dev.github.io/q2-micom).\n\n## Supported QIIME 2 versions\n\n`q2-micom` is tested against:\n\n1. the current [QIIME 2 version](https://docs.qiime2.org/)\n2. the previous version\n\nIt should also work with\n\n3. the [development version](https://dev.qiime2.org/latest/)<br>\n However, this may occasionally break. Check [here for the current status](https://github.com/micom-dev/q2-micom/actions/workflows/qiime_dev.yml).\n\n\n## References\n\nMICOM: Metagenome-Scale Modeling To Infer Metabolic Interactions in the Gut Microbiota <br>\nChristian Diener, Sean M. Gibbons, Osbaldo Resendis-Antonio <br>\nmSystems 5:e00606-19 <br>\nhttps://doi.org/10.1128/mSystems.00606-19\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "QIIME 2 plugin for metabolic modeling of microbial communities.",
"version": "0.16.0",
"project_urls": {
"Homepage": "https://github.com/micom-dev/q2-micom"
},
"split_keywords": [
"microbiome",
" modeling",
" metabolism",
" community"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "18ac09bac971015ad48f7dc9e67fb68bad125a0b8f7a11a9292916d160e4fdf6",
"md5": "d72f1a2060c11c69488f5afd326ba808",
"sha256": "5c2fb01c754e4899dad49c3c4f8536c60d0193eccce8370857ffa18d35719b52"
},
"downloads": -1,
"filename": "q2_micom-0.16.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d72f1a2060c11c69488f5afd326ba808",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 28972,
"upload_time": "2024-10-08T09:26:21",
"upload_time_iso_8601": "2024-10-08T09:26:21.033610Z",
"url": "https://files.pythonhosted.org/packages/18/ac/09bac971015ad48f7dc9e67fb68bad125a0b8f7a11a9292916d160e4fdf6/q2_micom-0.16.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "deae27e90ebe531fd3dd04f8904633e4940c99df3d96459e33a67fe50294b56c",
"md5": "131ece2bd2da9368a70d07c4576224e6",
"sha256": "bd5ed7f2e9c805abb597d3b12f61f6ad7623d39e9a98b32b02b0b6681472cd83"
},
"downloads": -1,
"filename": "q2-micom-0.16.0.tar.gz",
"has_sig": false,
"md5_digest": "131ece2bd2da9368a70d07c4576224e6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 24712,
"upload_time": "2024-10-08T09:26:22",
"upload_time_iso_8601": "2024-10-08T09:26:22.605437Z",
"url": "https://files.pythonhosted.org/packages/de/ae/27e90ebe531fd3dd04f8904633e4940c99df3d96459e33a67fe50294b56c/q2-micom-0.16.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-08 09:26:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "micom-dev",
"github_project": "q2-micom",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "q2-micom"
}
JSON
