Skip to content

Commit a99e9fd

Browse files
committed
Update programs used section
1 parent 54671ed commit a99e9fd

1 file changed

Lines changed: 34 additions & 13 deletions

File tree

README.md

Lines changed: 34 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
---
22
author: "Nicola F. Müller,Tim Vaughan"
33
beastversion: 2.4.2
4+
tracerversion: 1.6.0
5+
figtreeversion: 1.4.2
46
level: Professional
57
subtitle: Population structure using MultiTypeTree
68
title: Structured coalescent
@@ -11,24 +13,43 @@ title: Structured coalescent
1113
Population dynamics can influence the shape of a tree. Another thing that has strong influence on the shape of the tree is structure in a population. This is the case as soon as sequences do not mix well, i.e. they cluster together. One cause of this clustering is due to geography. Samples may not have been taken from the same geographic region, leading to clustering of samples from the same region. This clustering of samples can bias the estimation of parameters. The extension of the classic coalescent to the structured coalescent by allowing for migration between regions is trying to circumvent this by allowing individual regions to have distinct coalescent rates and by allowing migration between those regions.
1214

1315

16+
----
17+
18+
# Programs used in this Exercise
19+
20+
### BEAST2 - Bayesian Evolutionary Analysis Sampling Trees 2
21+
22+
BEAST2 ([http://www.beast2.org](http://www.beast2.org)) is a free software package for Bayesian evolutionary analysis of molecular sequences using MCMC and strictly oriented toward inference using rooted, time-measured phylogenetic trees. This tutorial is written for BEAST v{{ page.beastversion }} {% cite BEAST2book2014 --file Structured-coalescent/master-refs %}.
23+
24+
25+
### BEAUti2 - Bayesian Evolutionary Analysis Utility
26+
27+
BEAUti2 is a graphical user interface tool for generating BEAST2 XML configuration files.
28+
29+
Both BEAST2 and BEAUti2 are Java programs, which means that the exact same code runs on all platforms. For us it simply means that the interface will be the same on all platforms. The screenshots used in this tutorial are taken on a Mac OS X computer; however, both programs will have the same layout and functionality on both Windows and Linux. BEAUti2 is provided as a part of the BEAST2 package so you do not need to install it separately.
30+
31+
32+
### TreeAnnotator
33+
34+
TreeAnnotator is used to summarise the posterior sample of trees to produce a maximum clade credibility tree. It can also be used to summarise and visualise the posterior estimates of other tree parameters (e.g. node height).
1435

15-
# Programs used in this Exercise
36+
TreeAnnotator is provided as a part of the BEAST2 package so you do not need to install it separately.
1637

17-
### BEAST - Bayesian Evolutionary Analysis Sampling Trees
1838

19-
BEAST version 2.4.2 {% cite Bouckaert2014 --file Structured-coalescent/master-refs %}.
39+
### Tracer
2040

21-
### BEAUti - Bayesian Evolutionary Analysis Utility
41+
Tracer ([http://tree.bio.ed.ac.uk/software/tracer](http://tree.bio.ed.ac.uk/software/tracer)) is used to summarise the posterior estimates of the various parameters sampled by the Markov Chain. This program can be used for visual inspection and to assess convergence. It helps to quickly view median estimates and 95% highest posterior density intervals of the parameters, and calculates the effective sample sizes (ESS) of parameters. It can also be used to investigate potential parameter correlations. We will be using Tracer v{{ page.tracerversion }}.
2242

23-
GUI to create `*.xml` for BEAST2.
2443

25-
### Tracer
44+
### FigTree
45+
46+
FigTree ([http://tree.bio.ed.ac.uk/software/figtree](http://tree.bio.ed.ac.uk/software/figtree)) is a program for viewing trees and producing publication-quality figures. It can interpret the node-annotations created on the summary trees by TreeAnnotator, allowing the user to display node-based statistics (e.g. posterior probabilities). We will be using FigTree v{{ page.figtreeversion }}.
47+
48+
----
49+
2650

27-
Tracer ([http://tree.bio.ed.ac.uk/software/tracer](http://tree.bio.ed.ac.uk/software/tracer)) is used to summarize the posterior estimates of the various parameters sampled by the Markov Chain. It includes code to analyze estimates of past population dynamics from `*.log` files and `*.trees` files. It is mainly used for visual inspection and assessment of convergence of MCMC runs. It helps to quickly view median estimate and 95% credible intervals (which approximate the 95% highest posterior density intervals) of the parameters, and calculates the effective sample sizes (ESS) of parameters. It also helps to visualize potential parameter correlations.
2851

29-
### TreeAnnotator
3052

31-
TreeAnnotator is a program that comes with BEAST2. It allows to summarize the analysis of sampled trees.
3253

3354

3455

@@ -226,7 +247,11 @@ Next, we would like to know how certain we are about the node heights.
226247
- Despite considering structure in a tree, there might still be states or locations etc. that were not sampled. Even if a node is inferred to be in a location with high certainty, the results could look completely different if samples from other locations would be considered as well.
227248

228249

250+
----
229251

252+
# Acknowledgment
253+
254+
The content of this tutorial is based on the [MultiTypeTree](https://github.com/CompEvol/MultiTypeTree/wiki/Beginner's-Tutorial) tutorial by Tim Vaughan.
230255

231256

232257
# Useful Links
@@ -238,10 +263,6 @@ Next, we would like to know how certain we are about the node heights.
238263
- Join the BEAST user discussion: [http://groups.google.com/group/beast-users](http://groups.google.com/group/beast-users)
239264

240265

241-
----
242-
243-
The content of this tutorial is based on the [MultiTypeTree](https://github.com/CompEvol/MultiTypeTree/wiki/Beginner's-Tutorial) tutorial by Tim Vaughan.
244-
245266
----
246267

247268
# Relevant References

0 commit comments

Comments
 (0)