ClonalFrameML

Introduction

This is the homepage of ClonalFrameML, a software package that performs efficient inference of recombination in bacterial genomes. ClonalFrameML was created by Xavier Didelot and Daniel Wilson. ClonalFrameML can be applied to any type of aligned sequence data, but is especially aimed at analysis of whole genome sequences. It is able to compare hundreds of whole genomes in a matter of hours on a standard Desktop computer. There are three main outputs from a run of ClonalFrameML: a phylogeny with branch lengths corrected to account for recombination, an estimation of the key parameters of the recombination process, and a genomic map of where recombination took place for each branch of the phylogeny.

ClonalFrameML is a maximum likelihood implementation of the Bayesian software ClonalFrame which was previously described by Didelot and Falush (2007). The recombination model underpinning ClonalFrameML is exactly the same as for ClonalFrame, but this new implementation is a lot faster, is able to deal with much larger genomic dataset, and does not suffer from MCMC convergence issues. A scientific paper describing ClonalFrameML in detail has been published, see Didelot X, Wilson DJ (2015) ClonalFrameML: Efficient Inference of Recombination in Whole Bacterial Genomes. PLoS Comput Biol 11(2): e1004041. doi:10.1371/journal.pcbi.1004041.

Installation

Conda

 conda install -c conda-forge -c bioconda -c defaults clonalframeml

Homebrew

brew install brewsci/bio/clonalframeml

Source

You can obtain the most up to date version of ClonalFrameML by downloading and compiling the C++ source code via GIT using the command:

git clone https://github.com/xavierdidelot/ClonalFrameML
cd ClonalFrameML/src
make
./ClonalFrameML -version

Compilation requires a C++ compiler, such as GCC, to be installed. Running the bundled R scripts requires R to be installed with the ape and phangorn packages.

Run on test data

The following command can be used to test that ClonalFrameML was correctly installed:

ClonalFrameML testdata/test.nwk testdata/test.fasta testdata/out

User guide

The user guide for ClonalFrameML is available here.

Getting help

If you need assistance using ClonalFrameML, you can get in touch by emailing either Xavier Didelot or Daniel Wilson, or by asking on our Issues page.

License

Please note that the code for ClonalFrameML is distributed under the terms of the GNU GPL v3 license, for more details see https://www.gnu.org/copyleft/gpl.html