enrichm is a toolbox for comparing the functional composition of population genomes
EnrichM is a set of comparative genomics tools for large sets of metagenome assembled genomes (MAGs). The current functionality includes:
- An basic annotation pipeline for MAGs.
- A pipeline to determine the metabolic pathways that are encoded by MAGs, using KEGG modules as a reference (although custom pathways can be specified)
- A pipeline to identify genes or metabolic pathways that are enriched within and between user-defined groups of genomes (groups can be genomes that are related functionally, phylogenetically, recovered from different environments, etc).
- To construct metabolic networks from annotated population genomes.
- Construct random forest machine learning models from the functional composition of either MAGs, metagenomes or transcriptomes.
- Apply these random forest machine learning models to classify new MAGs metagenomes.
EnrichM is under active development, so there is no guaratee that master is stable. It's reccomended that EnrichM is downloaded either via pypi or conda (see below).
EnrichM is written in python 3, and required >v3.6 to run. EnrichM requires the following non-python dependencies:
- hmmer >= 3.1b
- seqmagick >= 0.6.1
- diamond == 0.9.22
- prodigal >= 2.6.3
- parallel >= 20180222
- mmseqs >= 2-23394
- R >= 3.0.1
- mcl >= 14-137
Install from PyPi like this:
sudo pip3 install enrichm
Install the conda package like so:
# Create a python3 environment for EnrichM. Replace "X.X.X" with the version number conda create -n enrichm_X.X.X python=3 # Activate that environment once it has compiled source activate enrichm_X.X.X # Install EnrichM's dependencies conda install -c bioconda mcl R hmmer diamond prodigal parallel openmp mmseqs2 moreutils # Install EnrichM itself conda install -c geronimp enrichm # Install R dependencies R install.packages(‘gridExtra’) install.packages(‘optparse’) q()
After this, you'll need to set up EnrichM to run by downloading its back end databases.
Loading EnrichM's database
Before running EnrichM, you'll need to download the back-end database. This file is large (5.7G) and contains all the reference databases EnrichM needs to annotate and compare your genomes. This includes Pfam-A HMMs, TIGRfam HMMs, a DIAMOND database of the sequences in uniref100 with EC and KO annotations, and KoFamKOALA HMMs. By default the database will be installed in your home directory. This is done using a command in EnrichM:
This should take approximately 15 minutes. To check for updates and install updates, simply run the same command. You can uninstall the database, using:
enrichm data --uninstall
Sepcifying the location of the EnrichM database
If you would like to store the EnrichM database outside of your home directory, move you need to tell EnrichM where to look. To do this, export a BASH variable named "ENRICHM_DB":
After which EnrichM should be able to find the database. It may be worthwhile putting this in your .bashrc so you dont have to re-run it every time you open a terminal.
Annotate is a function that allows you to annotate your population genomes with KO, PFAM, TIGRFAM, and CAZY using dbCAN. The result will be a .gff file for each genome, and a frequency matrix for each annotation type where the rows are annotation IDs and the columns are genomes.
See the annotate help page for more
Classify quickly reads in KO annotations in the form of a matrix (KO IDs as rows, genomes as columns) and determines which KEGG modules are complete. Annotation matrices can be generated using the annotate function.
See the classify help page for more
Enrichment will read in KO or PFAM annotations in the form of a matrix (IDs as rows, genomes as columns) and a metadata file that separates genomes into groups to compare, and will run some basic stats to determine the enrichment of modules or pfam clans between and within the groups.
See the enrichment help page for more
Pathway reads in a KO matrix and generates a Cytoscape-readable metabolic network and metadata file. Only reactions that are possible given the KOs present in the input matrix are shown, and the modules and reactions that are included in the output can be customized.
See the pathway help page for more
Explore is similar to pathway, but rather than generating a specified pathway it will start from a given query compound ID, and explore the possible reactions that use that compound given the enzymes present in the input KO matrix.
See the explore help page for more
EnrichM is licensed under the GNU GPL v3+. See LICENSE.txt for further details.
I want EnrichM to be as useful as possible, so please feel free to leave feature requests and bug reports.
A manuscript is in the final stages of preparation and a bioRxiv pre-print will be up shortly. If you find EnrichM useful and use it in your work, please cite it as follows:
Comparative genomics using EnrichM. Joel A Boyd Ben J Woodcroft Gene W Tyson. 2019. In preparation.
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size enrichm-0.5.0.tar.gz (57.9 kB)||File type Source||Python version None||Upload date||Hashes View hashes|