Package: metacoag
MetaCoAG: Binning Metagenomic Contigs via Composition, Coverage and Assembly GraphsMetaCoAG is a metagenomic contig binning tool that makes use of the connectivity information found in assembly graphs, apart from the composition and coverage information. MetaCoAG makes use of single-copy marker genes along with a graph matching technique and a label propagation technique to bin contigs. MetaCoAG is tested on contigs obtained from next-generation sequencing (NGS) data. Currently, MetaCoAG supports contigs assembled using metaSPAdes and MEGAHIT, and recently we have added support for Flye assemblies (has not been tested extensively).For detailed instructions on installation, usage and visualisation, please refer to thedocumentation hosted at Read the Docs.NEW:MetaCoAG is now available on bioconda athttps://anaconda.org/bioconda/metacoagand on PyPI athttps://pypi.org/project/metacoag/.DependenciesMetaCoAG installation requires Python 3.7 or above. You will need the following python dependencies to run MetaCoAG and related support scripts. The latest tested versions of the dependencies are listed as well.python- version 3.11.0python-igraph- version 0.10.4biopython- version 1.80networkx- version 3.0scipy- version 1.10.0numpy- version 1.24.2tqdm- version 4.64.1click- version 8.1.3MetaCoAG uses the following tools to scan for single-copy marker genes. These tools have been tested on the following versions.FragGeneScan- version 1.31HMMER- version 3.3.2Installing MetaCoAG using condaWe recommend that you usecondato run MetaCoAG.You can install MetaCoAG frombioconda.# add channelscondaconfig--addchannelsdefaults
condaconfig--addchannelsbioconda
condaconfig--addchannelsconda-forge# create conda environment and install metacoagcondacreate-nmetacoag-cbiocondametacoag# activate metacoag environmentcondaactivatemetacoag# check metacoag installationmetacoag-hSetting up MetaCoAG for developmentDownloading MetaCoAGYou can clone the MetaCoAG repository to your machine.git clone https://github.com/Vini2/MetaCoAG.gitNow go into the MetaCoAG folder using the commandcd MetaCoAG/UsingcondaOnce you have installedconda, make sure you are in the MetaCoAG folder. Now run the following commands to create acondaenvironment and activate it to run MetaCoAG.conda env create -f environment.yml
conda activate metacoagUsingpipYou can run the following command to install MetaCoAG usingpip. Make sure you are in the MetaCoAG folder.pip install .Note:If you use pip to setup MetaCoAG for development, you will have to installFragGeneScanandHMMERmanually and add them to your system path.Test the setupAfter setting up, run the following command to ensure that metacoag is working.metacoag -hExample Usagemetacoag --assembler spades --graph /path/to/graph_file.gfa --contigs /path/to/contigs.fasta --paths /path/to/paths_file.paths --abundance /path/to/abundance.tsv --output /path/to/output_foldermetacoag --assembler megahit --graph /path/to/graph_file.gfa --contigs /path/to/contigs.fasta --abundance /path/to/abundance.tsv --output /path/to/output_foldermetacoag --assembler flye --graph /path/to/assembly_graph.gfa --contigs /path/to/assembly.fasta --paths /path/to/assembly_info.txt --abundance /path/to/abundance.tsv --output /path/to/output_folderCitationMetaCoAG has been accepted atRECOMB 2022and is published in Lecture Notes in Computer Science athttps://doi.org/10.1007/978-3-031-04749-7_5and the journal extension is published in the Journal of Computational Biology athttps://www.liebertpub.com/doi/10.1089/cmb.2022.0262.If you use MetaCoAG in your work, please cite the following publications.@InProceedings{10.1007/978-3-031-04749-7_5,author="Mallawaarachchi, Vijini and Lin, Yu",editor="Pe'er, Itsik",title="MetaCoAG: Binning Metagenomic Contigs via Composition, Coverage and Assembly Graphs",booktitle="Research in Computational Molecular Biology",year="2022",publisher="Springer International Publishing",address="Cham",pages="70--85",abstract="Metagenomics has allowed us to obtain various genetic material from different species and gain valuable insights into microbial communities. Binning plays an important role in the early stages of metagenomic analysis pipelines. A typical pipeline in metagenomics binning is to assemble short reads into longer contigs and then bin into groups representing different species in the metagenomic sample. While existing binning tools bin metagenomic contigs, they do not make use of the assembly graphs that produce such assemblies. Here we propose MetaCoAG, a tool that utilizes assembly graphs with the composition and coverage information to bin metagenomic contigs. MetaCoAG uses single-copy marker genes to estimate the number of initial bins, assigns contigs into bins iteratively and adjusts the number of bins dynamically throughout the binning process. Experimental results on simulated and real datasets demonstrate that MetaCoAG significantly outperforms state-of-the-art binning tools, producing similar or more high-quality bins than the second-best tool. To the best of our knowledge, MetaCoAG is the first stand-alone contig-binning tool to make direct use of the assembly graph information.",isbn="978-3-031-04749-7"}@Article{doi:10.1089/cmb.2022.0262,author={Mallawaarachchi, Vijini and Lin, Yu},title={Accurate Binning of Metagenomic Contigs Using Composition, Coverage, and Assembly Graphs},journal={Journal of Computational Biology},volume={29},number={12},pages={1357--1376},year={2022},doi={10.1089/cmb.2022.0262},note={PMID: 36367700},URL={https://doi.org/10.1089/cmb.2022.0262},eprint={https://doi.org/10.1089/cmb.2022.0262},abstract={ Metagenomics enables the recovery of various genetic materials from different species, thus providing valuable insights into microbial communities. Metagenomic binning group sequences belong to different organisms, which is an important step in the early stages of metagenomic analysis pipelines. The classic pipeline followed in metagenomic binning is to assemble short reads into longer contigs and then bin these resulting contigs into groups representing different taxonomic groups in the metagenomic sample. Most of the currently available binning tools are designed to bin metagenomic contigs, but they do not make use of the assembly graphs that produce such assemblies. In this study, we propose MetaCoAG, a metagenomic binning tool that uses assembly graphs with the composition and coverage information of contigs. MetaCoAG estimates the number of initial bins using single-copy marker genes, assigns contigs into bins iteratively, and adjusts the number of bins dynamically throughout the binning process. We show that MetaCoAG significantly outperforms state-of-the-art binning tools by producing similar or more high-quality bins than the second-best binning tool on both simulated and real datasets. To the best of our knowledge, MetaCoAG is the first stand-alone contig-binning tool that directly makes use of the assembly graph information along with other features of the contigs. }}FundingMetaCoAG is funded by anEssential Open Source Software for Science Grantfrom the Chan Zuckerberg Initiative.