Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

enrichm is a toolbox for comparing the functional composition of population genomes

Project description

Build Status Downloads version status

EnrichM is a set of comparative genomics tools for large sets of metagenome assembled genomes (MAGs). The current functionality includes:

  1. An basic annotation pipeline for MAGs.
  2. A pipeline to determine the metabolic pathways that are encoded by MAGs, using KEGG modules as a reference (although custom pathways can be specified)
  3. 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).
  4. To construct metabolic networks from annotated population genomes.
  5. Construct random forest machine learning models from the functional composition of either MAGs, metagenomes or transcriptomes.
  6. 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:


Install from PyPi like this:

sudo pip3 install enrichm

conda (recommended)

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

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:

enrichm data

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":

export ENRICHM_DB=/path/to/database/

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


If you have any feedback about EnrichM, drop an email to the SupportM public help forum. Software by Joel A. Boyd (@geronimp) at the Australian Centre for Ecogenomics (ACE).


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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for enrichm, version 0.5.0
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

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page