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.

Download

You can download an executable for Mac from here.

You can download an executable for Linux Ubuntu from here.

You can download a snapshot of the source code from here.

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

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

Installation

If you download executables, you do not need to compile the source code. If you download the ClonalFrameML source code as described above, you can compile it using the following command:

cd clonalframeml/src make

or

cd clonalframeml/src ./make.sh

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.

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.