Escolar Documentos
Profissional Documentos
Cultura Documentos
4 2006-2012
Andrew Rambaut
Institute of Evolutionary Biology
University of Edinburgh
a.rambaut@ed.ac.uk
UNIX/Linux/Mac OS X (command-line) version README
Last updated: a.rambaut@ed.ac.uk - 8th October 2012
Contents:
1) INTRODUCTION
2) VERSION HISTORY
3) INSTALLATION
4) OPENING TREES
5) USING FIGTREE
6) EXPORTING RESULTS
7) SUPPORT & LINKS
8) ACKNOWLEDGMENTS
___________________________________________________________________________
1) INTRODUCTION
FigTree is designed as a graphical viewer of phylogenetic trees and as a program
for producing publication-ready figures. As with most of my programs, it was wr
itten for my own needs so may not be as polished and feature-complete as a comme
rcial program. On the other hand, I don't think there are any commercial tree dr
awing programs.
___________________________________________________________________________
2) VERSION HISTORY
v1.4 Released 8th October 2012.
New Features:
Added a 'Node Shape' option which can draw circles, squares or diamonds
on each node. These can be coloured and sized by attributes.
Added a 'Legend' option which can produce a colour legend for any attrib
ute/colour scheme being used.
New colour scheme for discrete attributes based on a HSB colour wheel. T
his replaces the old fixed sequence of colours and is more customizable. Attribu
te values can be re-ordered.
New colour scheme for continuous attributes also based on HSB. The old i
nterpolating colour scheme is still available.
Colour schemes are now selectable for particular attributes and these ar
e saved and loaded in FigTree files.
Numerous tweaks to the controls to make things more convenient. These in
clude the reintroduction of font size spinners (in addition to font selection di
alogs) and scrolling of the entire control panel when larger than the window.
New zooming/expansion. The maximum extent of zooming is now proportional
to the number of tips in the tree. I.e., the bigger the tree the more you can z
oom in. Also added a non-linearity to zooming (starts slower).
Bug Fixes:
Issue
ct.
Issue
Issue
Issue
Issue
Issue
Issue
52:
51:
50:
48:
45:
42:
39:
Bug Fixes:
Negative branch lengths are now correctly displayed rather than being tr
ansformed to unit branches.
Many, other bug fixes and improvements.
v1.0 Released 30th October 2006.
First Released Version
___________________________________________________________________________
3) INSTALLATION
FigTree requires a Java Virtual Machine to run. Many systems will already have t
his installed. It requires at least version 1.5 of Java to run. The latest versi
ons of Java can be downloaded from:
<http://java.sun.com/>
If in doubt type "java -version" to see what version of java is installed (or if
it is installed at all).
Mac OS X version 10.4 or better (Tiger) will already have a suitable version of
Java installed. I am sorry but FigTree simply doesn't run on older versions of M
ac OS X.
On Mac OS X and Windows, FigTree is run like any other application - double clic
k on the application icon.
On UNIX/Linux systems, you may be able to double-click on the figtree.jar file o
r execute the "figtree" shell script.
___________________________________________________________________________
4) OPENING TREES
Simply select "Open" from the "File" menu or on Mac, drag a suitable file onto t
he icon in Finder or the Dock. You can also set files with a particular extensio
n (say, ".tree") to open in FigTree as a default by selecting "Get Info", select
ing FigTree as the "Open With" application and then pressing the "Change All" bu
tton.
Trees can be in NEXUS or NEWICK format.
___________________________________________________________________________
5) USING FIGTREE
At present there is no manual for using FigTree. I suggest you simply try playin
g with the various controls and buttons.
___________________________________________________________________________
6) EXPORTING RESULTS
To export the figure for publication or further editing in a graphics package, s
elect "Export PDF" from the file menu to save as a PDF file.
Saving the tree from within FigTree will save in NEXUS format but add special co
mments and a command block which will enable FigTree to keep all the settings an
d annotations made to the tree. Other programs (such as PAUP) should ignore thes
e settings. You can also 'Copy and Paste' the tree into any application that acc
epts text (the result will be a NEXUS format tree file).
___________________________________________________________________________
7) SUPPORT & LINKS
FigTree is a new program and is not complete or bug-free. Please email me to mak
e suggestions or report bugs:
<a.rambaut@ed.ac.uk>
http://tree.bio.ed.ac.uk/
___________________________________________________________________________
8) ACKNOWLEDGMENTS
Thanks to the following for assisting with the creation or testing of FigTree:
Alexei Drummond
Joseph Heled
Philippe Lemey
Tulio de Oliveira
Oliver Pybus
Beth Shapiro
Marc Suchard