Home

Welcome to the EpiFusion wiki! This is a living document which will grow as we add improvements to the program, but for now it contains instructions on how to get started. Below is a very brief description of the key information you need to know, and you can find out more in other sections of the wiki.

Input Files

EpiFusion uses input files called 'XML' files as its input. If you are familiar with programs like BEAST, you will be familiar with this language (but EpiFusion inputs are less advanced). This file contains everything the program needs to run, including the data, parameters and priors for the analysis. There are example XML files in the 'examples' folder of this repo, but you can also find out more about each component of EpiFusion XML and learn how to assemble your own parameters in the 'EpiFusion XML Explained' section.

Program Installation

You can compile EpiFusion from source by cloning this repository and building the program within a java IDE, however this is unnecessarily complex, as we have executable files available on the releases page and these are much more stable. Better to download the latest release and place it into wherever folder you wish to call it from. We'll include more specific instructions on this in the 'Installation' section.

Running EpiFusion

When you have your EpiFusion XML assembled, you can run the program (provided you have Java 8 installed) with the following command.

java -jar EpiFusion.jar parameterfilename.xml

Interpreting EpiFusion Output

EpiFusion will create a directory within your working directory that corresponds to the 'fileBase' parameter in your EpiFusion xml file. For every MCMC chain, there will be 6 output files: likelihoods, acceptance, betas, params, rt, and trajectories. We have a number of useful R functions for 'parsing these outputs', available in the 'scripts' folder of the repository (we recommend sourcing 'epifusion_utilities.R'). Someday, we hope to distribute these utilities as an R package.