# pyMIBiG
[](https://pypi.org/project/pymibig)

A small tool to download, match and save sequences from [MIBiG](https://mibig.secondarymetabolites.org/).
`pyMIBiG` can search by "organism name", "compound / product",
"biosynthetic class" and "entry quality" as intersections of every argument added.
Which means that the more arguments you add more restrictive your search becomes.
It uses the available MIBiG download files which have less information then
those returned when using their web search. So, for very specific queries,
that yield fewer results, you will be better using the web interface.
## Usage
Download the available package of `pyMIBiG` and execute `pymibig -<target>`
where target is the term you wanto to search in MIBiG database.
You can also install it using `pip`. In a virtual environment execute:
```{console}
pip install pymibig
```
By default `pyMIBiG` will fetch all entry data and information of a given target.
You may change that using optional aguments passed along with the `<target>`:
```{console}
usage: pyMIBiG [-h] [-o ORGANISM] [-p PRODUCT] [-b BIOSYNT] [-c {complete,incomplete,unknown,all}] [-q {low,medium,high,questionable,all}]
A small tool to download, match and save targeted sequences from MIBiG.
options:
-h, --help show this help message and exit
-o ORGANISM, --organism ORGANISM
Organism name to query in database.
-p PRODUCT, --product PRODUCT
Compound to query in database.
-b BIOSYNT, --biosynt BIOSYNT
Biosynthetic class to query in database.
-c {complete,incomplete,unknown,all}, --completeness {complete,incomplete,unknown,all}
Loci completeness.
-q {low,medium,high,questionable,all}, --quality {low,medium,high,questionable,all}
Entry quality level.
```
You have to use at least one of the following arguments: organism, product or
biosynt. The others are optional.
On first execution `pyMIBiG` will download the database files from
[MIBiG](https://mibig.secondarymetabolites.org/download) and save locally,
so an internet connection will be needed, after that it can be used offline.
Latest release of `pyMIBiG` will download from MIBiG
**Version 4.0 (November 15, 2024)** the:
- [Metadata](https://dl.secondarymetabolites.org/mibig/mibig_json_4.0.tar.gz)
in compressed format, including several JSON files;
- [Nucleotide](https://dl.secondarymetabolites.org/mibig/mibig_gbk_4.0.tar.gz)
sequences of the biosynthetic gene clusters in compressed format, including
several GBK files;
- [Amino acid sequence translations](https://dl.secondarymetabolites.org/mibig/mibig_prot_seqs_4.0.fasta)
of all genes from MIBiG entries are also available in a single compressed
FASTa file.
Version 1.2.7 uses MIBiG **Version 3.1 (October 7, 2022)**.
## Output
`pyMIBiG` will create three files:
- a FASTa containing nucleotide sequences
- a FASTa containing aminoacid sequences
- a tab-separated value table with information on the selected sequences
The filenames will reflect the parameters used when searching the database.
Ps.: Retired entries will be presented in the table, but there will be no sequences for them.
## Reference
[MIBiG 4.0: Advancing Biosynthetic Gene Cluster Curation through Global Collaboration.](https://doi.org/10.1093/nar/gkae1115)
## License
`pyMiBiG` is distributed under the terms of the [LGPL 3.0](https://spdx.org/licenses/LGPL-3.0-or-later.html) license.
Raw data
{
"_id": null,
"home_page": null,
"name": "pymibig",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "Biosynthetic Gene Cluster, MIBiG, Secondary Metabolites, bioinformatics",
"author": null,
"author_email": "Rodrigo Aluizio <r.aluizio@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/c5/d6/1f0a15c8cb458dcf2e6e3bb60399ca0cbee8f58654328809f90a60ea5649/pymibig-1.4.0.tar.gz",
"platform": null,
"description": "# pyMIBiG\n\n[](https://pypi.org/project/pymibig)\n\n\n\nA small tool to download, match and save sequences from [MIBiG](https://mibig.secondarymetabolites.org/).\n\n`pyMIBiG` can search by \"organism name\", \"compound / product\",\n\"biosynthetic class\" and \"entry quality\" as intersections of every argument added.\nWhich means that the more arguments you add more restrictive your search becomes.\nIt uses the available MIBiG download files which have less information then\nthose returned when using their web search. So, for very specific queries,\nthat yield fewer results, you will be better using the web interface.\n\n## Usage\n\nDownload the available package of `pyMIBiG` and execute `pymibig -<target>`\nwhere target is the term you wanto to search in MIBiG database.\n\nYou can also install it using `pip`. In a virtual environment execute:\n\n```{console}\npip install pymibig\n```\n\nBy default `pyMIBiG` will fetch all entry data and information of a given target.\n\nYou may change that using optional aguments passed along with the `<target>`:\n\n```{console}\nusage: pyMIBiG [-h] [-o ORGANISM] [-p PRODUCT] [-b BIOSYNT] [-c {complete,incomplete,unknown,all}] [-q {low,medium,high,questionable,all}]\n\nA small tool to download, match and save targeted sequences from MIBiG.\n\noptions:\n -h, --help show this help message and exit\n -o ORGANISM, --organism ORGANISM\n Organism name to query in database.\n -p PRODUCT, --product PRODUCT\n Compound to query in database.\n -b BIOSYNT, --biosynt BIOSYNT\n Biosynthetic class to query in database.\n -c {complete,incomplete,unknown,all}, --completeness {complete,incomplete,unknown,all}\n Loci completeness.\n -q {low,medium,high,questionable,all}, --quality {low,medium,high,questionable,all}\n Entry quality level.\n```\n\nYou have to use at least one of the following arguments: organism, product or\nbiosynt. The others are optional.\n\nOn first execution `pyMIBiG` will download the database files from\n[MIBiG](https://mibig.secondarymetabolites.org/download) and save locally,\nso an internet connection will be needed, after that it can be used offline.\n\nLatest release of `pyMIBiG` will download from MIBiG\n**Version 4.0 (November 15, 2024)** the:\n- [Metadata](https://dl.secondarymetabolites.org/mibig/mibig_json_4.0.tar.gz)\nin compressed format, including several JSON files;\n- [Nucleotide](https://dl.secondarymetabolites.org/mibig/mibig_gbk_4.0.tar.gz)\nsequences of the biosynthetic gene clusters in compressed format, including\nseveral GBK files;\n- [Amino acid sequence translations](https://dl.secondarymetabolites.org/mibig/mibig_prot_seqs_4.0.fasta)\nof all genes from MIBiG entries are also available in a single compressed\nFASTa file.\n\nVersion 1.2.7 uses MIBiG **Version 3.1 (October 7, 2022)**.\n\n## Output\n\n`pyMIBiG` will create three files:\n- a FASTa containing nucleotide sequences\n- a FASTa containing aminoacid sequences\n- a tab-separated value table with information on the selected sequences\n\nThe filenames will reflect the parameters used when searching the database.\n\nPs.: Retired entries will be presented in the table, but there will be no sequences for them.\n\n## Reference\n[MIBiG 4.0: Advancing Biosynthetic Gene Cluster Curation through Global Collaboration.](https://doi.org/10.1093/nar/gkae1115)\n\n## License\n\n`pyMiBiG` is distributed under the terms of the [LGPL 3.0](https://spdx.org/licenses/LGPL-3.0-or-later.html) license.\n",
"bugtrack_url": null,
"license": "LGPL-3.0-or-later",
"summary": "A small tool to download, match and save sequences from MIBiG.",
"version": "1.4.0",
"project_urls": {
"Documentation": "https://github.com/Godrigos/pyMIBiG#readme",
"Issues": "https://github.com/Godrigos/pyMIBiG/issues",
"Source": "https://github.com/Godrigos/pyMIBiG"
},
"split_keywords": [
"biosynthetic gene cluster",
" mibig",
" secondary metabolites",
" bioinformatics"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "602c90ec3781adc7f3742e0cdcb702d3922e0b629ef2ef859a295666f47df2a3",
"md5": "2f3d43018ec2b166f7d25b240b2cc4bf",
"sha256": "5d45098d7a1eeff988f76564f2ccd0610ec1d7fee5ea91a6f7b6e441bda64b05"
},
"downloads": -1,
"filename": "pymibig-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2f3d43018ec2b166f7d25b240b2cc4bf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 14455,
"upload_time": "2024-12-05T17:31:09",
"upload_time_iso_8601": "2024-12-05T17:31:09.327814Z",
"url": "https://files.pythonhosted.org/packages/60/2c/90ec3781adc7f3742e0cdcb702d3922e0b629ef2ef859a295666f47df2a3/pymibig-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c5d61f0a15c8cb458dcf2e6e3bb60399ca0cbee8f58654328809f90a60ea5649",
"md5": "e6c808733e9e13750c84373018a1538e",
"sha256": "489b3fca57558b20d52a6e3c8e8729f3961f21cea928d31c054e286cda8b5720"
},
"downloads": -1,
"filename": "pymibig-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "e6c808733e9e13750c84373018a1538e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 10247,
"upload_time": "2024-12-05T17:31:10",
"upload_time_iso_8601": "2024-12-05T17:31:10.581062Z",
"url": "https://files.pythonhosted.org/packages/c5/d6/1f0a15c8cb458dcf2e6e3bb60399ca0cbee8f58654328809f90a60ea5649/pymibig-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-05 17:31:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Godrigos",
"github_project": "pyMIBiG#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pymibig"
}