[](http://bioconda.github.io/recipes/binette/README.html) [](https://anaconda.org/bioconda/binette)
[](https://anaconda.org/bioconda/binette)
[](https://anaconda.org/bioconda/binette)
[](https://badge.fury.io/py/Binette)
[](https://joss.theoj.org/papers/ad304709d59f1a51a31614393b09ba2b)
[](https://genotoul-bioinfo.github.io/Binette/)
[](https://github.com/genotoul-bioinfo/Binette/actions/workflows)
[](https://binette.readthedocs.io/en/latest/?badge=latest)
# Binette
Binette is a fast and accurate binning refinement tool to constructs high quality MAGs from the output of multiple binning tools.
From the input bin sets, Binette constructs new hybrid bins. A bin can be seen as a set of contigs. When at least two bins overlap, meaning they share at least one contig, Binette utilizes basic set operations to create new bins.
- Intersection bin: This bin consists of the contigs that are shared by the overlapping bins.
- Difference bin: This bin contains the contigs that are exclusively found in one bin and not present in the others.
- Union bin: The union bin includes all the contigs contained within the overlapping bins
It then uses CheckM2 to assess bins quality to finally select the best bins possible.
Binette is inspired from the metaWRAP bin-refinement tool but it effectively solves all the problems from that very tool.
- Enhanced Speed: Binette significantly improves the speed of the refinement process. It achieves this by launching the initial steps of CheckM2, such as Prodigal and Diamond runs, only once on all contigs. These intermediate results are then utilized to assess the quality of any given bin, eliminating redundant computations and accelerating the refinement process.
- No Limit on Input Bin Sets: Unlike its predecessor, Binette is not constrained by the number of input bin sets. It can handle and process multiple bin sets simultaneously.
<!-- - Bin selection have been improved. It selects the best bins in a more accurate and elegant manner.
- It is easier to use. -->
A comprehensive documentation of Binette is avalaible here: https://binette.readthedocs.io/
# Installation
## With Bioconda
Binette can be easilly installed with conda
```bash
conda create -c bioconda -c defaults -c conda-forge -n binette binette
conda activate binette
```
Binette should be able to run :
```
binette -h
```
## From a conda environnement
Clone this repository:
```
git clone https://github.com/genotoul-bioinfo/Binette
cd Binette
```
Then create a Conda environment using the `binette.yaml` file:
```
conda env create -n binette -f binette.yaml
conda activate binette
```
Finally install Binette with pip
```
pip install .
```
Binette should be able to run :
```
binette -h
```
## Downloading the CheckM2 database
Before using Binette, it is necessary to download the CheckM2 database:
```bash
checkm2 database --download --path <checkm2/database/>
```
Make sure to replace `<checkm2/database/>` with the desired path where you want to store the CheckM2 database.
# Usage
## Input Formats
Binette supports two input formats for bin sets:
1. **Contig2bin Tables:** You can provide bin sets using contig2bin tables, which establish the relationship between each contig and its corresponding bin. In this format, you need to specify the `--contig2bin_tables` argument.
For example, consider the following two `contig2bin_tables`:
- `bin_set1.tsv`:
```tsv
contig_1 binA
contig_8 binA
contig_15 binB
contig_9 binC
```
- `bin_set2.tsv`:
```tsv
contig_1 bin.0
contig_8 bin.0
contig_15 bin.1
contig_9 bin.2
contig_10 bin.0
```
The `binette` command to process this input would be:
```bash
binette --contig2bin_tables bin_set1.tsv bin_set2.tsv --contigs assembly.fasta
```
2. **Bin Directories:** Alternatively, you can use bin directories, where each bin is represented by a separate FASTA file. For this format, you need to provide the `--bin_dirs` argument. Here's an example of two bin directories:
```
bin_set1/
├── binA.fa: contains sequences of contig_1, contig_8
├── binB.fa: contains sequences of contig_15
└── binC.fa: contains sequences of contig_9
```
```
bin_set2/
├── binA.fa: contains sequences of contig_1, contig_8, contig_10
├── binB.fa: contains sequences of contig_15
└── binC.fa: contains sequences of contig_9
```
The `binette` command to process this input would be:
```bash
binette --bin_dirs bin_set1 bin_set2 --contigs assembly.fasta
```
In both formats, the `--contigs` argument should specify a FASTA file containing all the contigs found in the bins. Typically, this file would be the assembly FASTA file used to generate the bins. In these exemple the `assembly.fasta` file should contain at least the five contigs mentioned in the `contig2bin_tables` files or in the bin fasta files: `contig_1`, `contig_8`, `contig_15`, `contig_9`, and `contig_10`.
## Outputs
Binette results are stored in the `results` directory. You can specify a different directory using the `--outdir` option.
In this directory you will find:
- **`final_bins_quality_reports.tsv`**: This is a TSV (tab-separated values) file containing quality information about the final selected bins.
- **`final_bins/`**: This directory stores all the selected bins in fasta format.
- **`input_bins_quality_reports/`**: A directory storing quality reports for the input bin sets, with files following the same structure as `final_bins_quality_reports.tsv`.
- **`temporary_files/`**: This directory contains intermediate files. If you choose to use the `--resume` option, Binette will utilize files in this directory to prevent the recomputation of time-consuming steps.
The `final_bins_quality_reports.tsv` file contains the following columns:
| Column Name | Description |
|---------------------|--------------------------------------------------------------------------------------------------------------|
| **bin_id** | This column displays the unique ID of the bin. |
| **origin** | Indicates the source or origin of the bin, specifying from which bin set it originates or the intermediate set operation that created it. |
| **name** | The name of the bin. |
| **completeness** | The completeness of the bin, determined by CheckM2. |
| **contamination** | The contamination of the bin, determined by CheckM2. |
| **score** | This column displays the computed score, which is calculated as: `completeness - contamination * weight`. You can customize the contamination weight using the `--contamination_weight` option. |
| **size** | Represents the size of the bin in nucleotides. |
| **N50** | Displays the N50 of the bin. |
| **contig_count** | The number of contigs contained within the bin. |
# Help, feature requests and bug reporting
To report bugs, request new features, or seek help and support, please open an [issue](https://github.com/genotoul-bioinfo/Binette/issues).
# Licence
This program is released as an open source software under the terms of [MIT License](LICENSE).
Raw data
{
"_id": null,
"home_page": null,
"name": "Binette",
"maintainer": "Jean Mainguy",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "Bioinformatics, Prokaryote, Binning, Refinement, Metagenomics",
"author": "Jean Mainguy",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/52/a4/7d9aa252d42bbaf1ba74ea7245625d0f65131c5502da78260cfb2f9cc127/binette-1.0.3.tar.gz",
"platform": null,
"description": "[](http://bioconda.github.io/recipes/binette/README.html) [](https://anaconda.org/bioconda/binette)\n[](https://anaconda.org/bioconda/binette) \n[](https://anaconda.org/bioconda/binette)\n[](https://badge.fury.io/py/Binette)\n[](https://joss.theoj.org/papers/ad304709d59f1a51a31614393b09ba2b)\n\n[](https://genotoul-bioinfo.github.io/Binette/) \n[](https://github.com/genotoul-bioinfo/Binette/actions/workflows)\n[](https://binette.readthedocs.io/en/latest/?badge=latest)\n\n\n# Binette \n\nBinette is a fast and accurate binning refinement tool to constructs high quality MAGs from the output of multiple binning tools.\n\nFrom the input bin sets, Binette constructs new hybrid bins. A bin can be seen as a set of contigs. When at least two bins overlap, meaning they share at least one contig, Binette utilizes basic set operations to create new bins.\n- Intersection bin: This bin consists of the contigs that are shared by the overlapping bins. \n- Difference bin: This bin contains the contigs that are exclusively found in one bin and not present in the others.\n- Union bin: The union bin includes all the contigs contained within the overlapping bins\n\nIt then uses CheckM2 to assess bins quality to finally select the best bins possible.\n\nBinette is inspired from the metaWRAP bin-refinement tool but it effectively solves all the problems from that very tool. \n- Enhanced Speed: Binette significantly improves the speed of the refinement process. It achieves this by launching the initial steps of CheckM2, such as Prodigal and Diamond runs, only once on all contigs. These intermediate results are then utilized to assess the quality of any given bin, eliminating redundant computations and accelerating the refinement process.\n- No Limit on Input Bin Sets: Unlike its predecessor, Binette is not constrained by the number of input bin sets. It can handle and process multiple bin sets simultaneously.\n<!-- - Bin selection have been improved. It selects the best bins in a more accurate and elegant manner.\n- It is easier to use. -->\n\nA comprehensive documentation of Binette is avalaible here: https://binette.readthedocs.io/\n\n# Installation\n\n## With Bioconda\n\nBinette can be easilly installed with conda \n\n```bash\nconda create -c bioconda -c defaults -c conda-forge -n binette binette\nconda activate binette\n```\n\nBinette should be able to run :\n\n```\nbinette -h\n```\n\n\n## From a conda environnement\n\nClone this repository: \n```\ngit clone https://github.com/genotoul-bioinfo/Binette\ncd Binette\n```\n\nThen create a Conda environment using the `binette.yaml` file:\n```\nconda env create -n binette -f binette.yaml\nconda activate binette \n```\n\nFinally install Binette with pip\n\n```\npip install .\n```\n\nBinette should be able to run :\n\n```\nbinette -h\n```\n\n\n## Downloading the CheckM2 database\n\nBefore using Binette, it is necessary to download the CheckM2 database:\n\n```bash\ncheckm2 database --download --path <checkm2/database/>\n```\n\nMake sure to replace `<checkm2/database/>` with the desired path where you want to store the CheckM2 database.\n\n\n# Usage \n\n## Input Formats\n\nBinette supports two input formats for bin sets: \n\n1. **Contig2bin Tables:** You can provide bin sets using contig2bin tables, which establish the relationship between each contig and its corresponding bin. In this format, you need to specify the `--contig2bin_tables` argument. \n\nFor example, consider the following two `contig2bin_tables`:\n\n- `bin_set1.tsv`:\n\n ```tsv\n contig_1 binA\n contig_8 binA\n contig_15 binB\n contig_9 binC\n ```\n \n- `bin_set2.tsv`:\n\n ```tsv\n contig_1 bin.0\n contig_8 bin.0\n contig_15 bin.1\n contig_9 bin.2\n contig_10 bin.0\n ```\n \n The `binette` command to process this input would be:\n \n ```bash\n binette --contig2bin_tables bin_set1.tsv bin_set2.tsv --contigs assembly.fasta\n ```\n\n2. **Bin Directories:** Alternatively, you can use bin directories, where each bin is represented by a separate FASTA file. For this format, you need to provide the `--bin_dirs` argument. Here's an example of two bin directories:\n\n ```\n bin_set1/\n \u251c\u2500\u2500 binA.fa: contains sequences of contig_1, contig_8\n \u251c\u2500\u2500 binB.fa: contains sequences of contig_15\n \u2514\u2500\u2500 binC.fa: contains sequences of contig_9\n ```\n \n ```\n bin_set2/\n \u251c\u2500\u2500 binA.fa: contains sequences of contig_1, contig_8, contig_10\n \u251c\u2500\u2500 binB.fa: contains sequences of contig_15\n \u2514\u2500\u2500 binC.fa: contains sequences of contig_9\n ```\n \n The `binette` command to process this input would be:\n \n ```bash\n binette --bin_dirs bin_set1 bin_set2 --contigs assembly.fasta\n ```\n\nIn both formats, the `--contigs` argument should specify a FASTA file containing all the contigs found in the bins. Typically, this file would be the assembly FASTA file used to generate the bins. In these exemple the `assembly.fasta` file should contain at least the five contigs mentioned in the `contig2bin_tables` files or in the bin fasta files: `contig_1`, `contig_8`, `contig_15`, `contig_9`, and `contig_10`.\n\n## Outputs\n\nBinette results are stored in the `results` directory. You can specify a different directory using the `--outdir` option.\n\nIn this directory you will find:\n- **`final_bins_quality_reports.tsv`**: This is a TSV (tab-separated values) file containing quality information about the final selected bins.\n- **`final_bins/`**: This directory stores all the selected bins in fasta format.\n- **`input_bins_quality_reports/`**: A directory storing quality reports for the input bin sets, with files following the same structure as `final_bins_quality_reports.tsv`.\n- **`temporary_files/`**: This directory contains intermediate files. If you choose to use the `--resume` option, Binette will utilize files in this directory to prevent the recomputation of time-consuming steps.\n\n\nThe `final_bins_quality_reports.tsv` file contains the following columns:\n| Column Name | Description |\n|---------------------|--------------------------------------------------------------------------------------------------------------|\n| **bin_id** | This column displays the unique ID of the bin. |\n| **origin** | Indicates the source or origin of the bin, specifying from which bin set it originates or the intermediate set operation that created it. |\n| **name** | The name of the bin. |\n| **completeness** | The completeness of the bin, determined by CheckM2. |\n| **contamination** | The contamination of the bin, determined by CheckM2. |\n| **score** | This column displays the computed score, which is calculated as: `completeness - contamination * weight`. You can customize the contamination weight using the `--contamination_weight` option. |\n| **size** | Represents the size of the bin in nucleotides. |\n| **N50** | Displays the N50 of the bin. |\n| **contig_count** | The number of contigs contained within the bin. |\n\n# Help, feature requests and bug reporting\n\nTo report bugs, request new features, or seek help and support, please open an [issue](https://github.com/genotoul-bioinfo/Binette/issues). \n\n\n# Licence\n\nThis program is released as an open source software under the terms of [MIT License](LICENSE).\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Binette: accurate binning refinement tool to constructs high quality MAGs.",
"version": "1.0.3",
"project_urls": {
"Documentation": "https://binette.readthedocs.io",
"Repository": "https://github.com/genotoul-bioinfo/Binette"
},
"split_keywords": [
"bioinformatics",
" prokaryote",
" binning",
" refinement",
" metagenomics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "145edefc1ae1f399c9a7bf391a02c5837d29885c029cc887d1f0a91d301a9737",
"md5": "d1f81b9a5c96fa13f50caf27c5ed1478",
"sha256": "5e6618bb7336ddecae3937880b49c5fba69141bfa84367581366065444e5e03b"
},
"downloads": -1,
"filename": "Binette-1.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d1f81b9a5c96fa13f50caf27c5ed1478",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 25610,
"upload_time": "2024-09-19T09:37:00",
"upload_time_iso_8601": "2024-09-19T09:37:00.508697Z",
"url": "https://files.pythonhosted.org/packages/14/5e/defc1ae1f399c9a7bf391a02c5837d29885c029cc887d1f0a91d301a9737/Binette-1.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "52a47d9aa252d42bbaf1ba74ea7245625d0f65131c5502da78260cfb2f9cc127",
"md5": "81c867f364160e6d25e4a4d4ee127151",
"sha256": "f60bbf04256597c5708aba33e9ac5b3fb0f7c21515c1e9c5b3f36c215e6f213d"
},
"downloads": -1,
"filename": "binette-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "81c867f364160e6d25e4a4d4ee127151",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 88863,
"upload_time": "2024-09-19T09:37:02",
"upload_time_iso_8601": "2024-09-19T09:37:02.564902Z",
"url": "https://files.pythonhosted.org/packages/52/a4/7d9aa252d42bbaf1ba74ea7245625d0f65131c5502da78260cfb2f9cc127/binette-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-19 09:37:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "genotoul-bioinfo",
"github_project": "Binette",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "binette"
}
JSON
