dualbrothers: Recombination Analysis via DualBrothers

Description Usage Arguments Details Value References

Description

DualBrothers generates a posterior sample based on the dual Multiple Change-Point model.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
dualbrothers(seed,alignment,format="interleaved",window.size=NULL,

             basename=alignment,length=2100000,burnin=100000,

             subsample=200,par_lambda=NULL,top_lambda=NULL,
 
             window_length=10,C=0.3,sigma_alpha=0.75,
 
             sigma_mu=0.75,subst_hyper_mean=-1,

             subst_hyper_variance=-1,diver_hyper_mean=-1,

             diver_hyper_variance=-1,top_breaks=1,par_breaks=1,

             step.size=10,boot=0,inputtrees=NULL)

Arguments

seed

integer used to seed the pseudo-random number generator (required)

alignment

a string in quotes ("alignment") that requires the alignment.fasta file or the alignment.phy file to be in the current working directory (required)

format

a string, either "fasta" or "interleaved"

window.size

a vector of positive integers indicating the widths of the windows (in base pairs) used to create the set of candidate trees (required if the number of taxa is greater than 6)

basename

a string in quotes ("basename") to be used for output files

length

a positive integer indicating the total number of samples to generate

burnin

a positive integer indicating the number of initial samples to discard

subsample

a positive number indicating the frequency at which samples are saved to the output file after the burnin

par_lambda

hyperprior parameter representing the prior mean number of substitution process change-points

top_lambda

hyperprior parameter representing the prior mean number of topology break-points

window_length

size of window around which existing change-points are randomly moved during the update of Peter Green's constant

C

Peter Green's constant. Adjust this constant to change the proportion of time that the sampler spends updating parameters when the number of dimensions is fixed.

sigma_alpha

spread of alphas when proposing new segments

sigma_mu

spread of mus when proposing new segments

subst_hyper_mean

prior mean of log kappa

subst_hyper_variance

prior variance of log kappa

diver_hyper_mean

prior mean of log mu

diver_hyper_variance

prior variance of log mu

top_breaks

1 = include topology break-points into the model, 0 = do not include

par_breaks

1 = include substitution change-points in the model, 0 = do not include

step.size

a positive integer indicating the number of base pairs to move the window used to create the set of candidate trees

boot

a non-negative integer indicating the number of times to bootstrap each window when creating candidate trees

inputtrees

a string, the name of the file (in the current working directory) containing the input trees for DualBrothers

Details

DualBrothers is a recombination detection software based on the dual Multiple Change-Point model. This model allows for changes in topology and evolutionary rates across sites in a multiple sequence alignment. DualBrothers uses a Bayesian approach together with an MCMC sampling to simulate from the posterior distribution of the dual MCP model parameters. More information can be found at http://www.biomath.ucla.edu/msuchard/DualBrothers/.

Value

DualBrothers creates a basename.post file in the current working directory.

References

Minin VN, Dorman KS, Suchard MA. (2005). Dual multiple change-point model leads to more accurate recombination detection. Bioinformatics, 21:3034-3042.


vnminin/rbrothers documentation built on May 3, 2019, 6:38 p.m.