... |
... |
@@ -38,7 +38,10 @@ Biocpkg <- function (pkg) {
|
38 |
38 |
|
39 |
39 |
```
|
40 |
40 |
|
41 |
|
-> You can't even begin to understand biology, you can't understand life, unless you understand what it's all there for, how it arose - and that means evolution.
|
|
41 |
+> You can't even begin to understand biology, you can't understand life, unless
|
|
42 |
+> you understand what it's all there for, how it arose - and that means
|
|
43 |
+> evolution.
|
|
44 |
+>
|
42 |
45 |
> --- Richard Dawkins
|
43 |
46 |
|
44 |
47 |
|
... |
... |
@@ -114,7 +117,12 @@ visualize or annotate phylogenetic tree in `r Biocpkg('ggtree')` [@yu_ggtree:_20
|
114 |
117 |
|
115 |
118 |
# Tree Visualization and Annotation
|
116 |
119 |
|
117 |
|
-Tree Visualization in `ggtree` is easy, with one line of command `ggtree(tree_object)`. It supports several layouts, including `rectangular`, `slanted` and `circular` for `Phylogram` and `Cladogram`, `unrooted` layout, time-scaled and two dimentional phylogenies. [Tree Visualization](treeVisualization.html) vignette describes these feature in details.
|
|
120 |
+Tree Visualization in `r Biocpkg('ggtree')` is easy, with one line of command
|
|
121 |
+`ggtree(tree_object)`. It supports several layouts, including *rectangular*,
|
|
122 |
+*slanted*, *circular* and *fan* for *phylogram* and *cladogram*, *equal_angle*
|
|
123 |
+and *daylight* for *unrooted* layout, time-scaled and two dimentional
|
|
124 |
+phylogenies. [Tree Visualization](treeVisualization.html) vignette describes
|
|
125 |
+these feature in details.
|
118 |
126 |
|
119 |
127 |
We implement several functions to manipulate a phylogenetic tree.
|
120 |
128 |
|
... |
... |
@@ -125,27 +133,73 @@ We implement several functions to manipulate a phylogenetic tree.
|
125 |
133 |
+ selected clade can be rotated by 180 degree using `rotate` function
|
126 |
134 |
+ position of two selected clades (should share a same parent) can be exchanged by `flip` function
|
127 |
135 |
|
|
136 |
+
|
128 |
137 |
Details and examples can be found in [Tree Manipulation](treeManipulation.html) vignette.
|
129 |
138 |
|
130 |
139 |
|
131 |
|
-Most of the phylogenetic trees are scaled by evolutionary distance (substitution/site), in `ggtree` a phylogenetic tree can be re-scaled by any numerical variable inferred by evolutionary analysis (e.g. species divergence time, *dN/dS*, _etc_). Numerical and category variable can be used to color a phylogenetic tree.
|
|
140 |
+Most of the phylogenetic trees are scaled by evolutionary distance
|
|
141 |
+(substitution/site), in `r Biocpkg('ggtree')` a phylogenetic tree can be
|
|
142 |
+re-scaled by any numerical variable inferred by evolutionary analysis (e.g.
|
|
143 |
+species divergence time, *d~N~/d~S~*, _etc_). Numerical and category variable can be
|
|
144 |
+used to color a phylogenetic tree.
|
|
145 |
+
|
|
146 |
+The `r Biocpkg('ggtree')` package provides several layers to annotate a
|
|
147 |
+phylogenetic tree. These layers are building blocks that can be freely combined
|
|
148 |
+together to create complex tree visualization.
|
|
149 |
+
|
|
150 |
+```{r geoms, echo=FALSE, message=FALSE}
|
|
151 |
+geoms <- matrix(c(
|
|
152 |
+ "geom_balance", "highlights the two direct descendant clades of an internal node",
|
|
153 |
+ "geom_cladelabel", "annotate a clade with bar and text label",
|
|
154 |
+ "geom_cladelabel2", "annotate a clade with bar and text label for unrooted layout",
|
|
155 |
+ "geom_hilight", "highlight a clade with rectangle",
|
|
156 |
+ "geom_hilight_encircle", "highlight a clade with xspline for unrooted layout",
|
|
157 |
+ "geom_label2", "modified version of geom_label, with subsetting supported",
|
|
158 |
+ "geom_nodelab", "layer for node labels, which can be text or image",
|
|
159 |
+ "geom_nodepoint", "annotate internal nodes with symbolic points",
|
|
160 |
+ "geom_point2", "modified version of geom_point, with subsetting supported",
|
|
161 |
+ "geom_range", "bar layer to present uncertainty of evolutionary inference",
|
|
162 |
+ "geom_rootpoint", "annotate root node with symbolic point",
|
|
163 |
+ "geom_segment2", "modified version of geom_segment, with subsetting supported",
|
|
164 |
+ "geom_strip", "annotate associated taxa with bar and (optional) text label",
|
|
165 |
+ "geom_taxalink", "associate two related taxa by linking them with a curve",
|
|
166 |
+ "geom_text2", "modified version of geom_text, with subsetting supported",
|
|
167 |
+ "geom_tiplab", "layer of tip labels, which can be text or image",
|
|
168 |
+ "geom_tiplab2", "layer of tip labels for circular layout",
|
|
169 |
+ "geom_tippoint", "annotate external nodes with symbolic points",
|
|
170 |
+ "geom_tree", "tree structure layer, with multiple layout supported",
|
|
171 |
+ "geom_treescale", "tree branch scale legend"
|
|
172 |
+), ncol=2, byrow=TRUE)
|
|
173 |
+geoms <- as.data.frame(geoms)
|
|
174 |
+colnames(geoms) <- c("Layer", "Description")
|
|
175 |
+knitr::kable(geoms, caption = "Geom layers defined in ggtree.", booktabs = T)
|
|
176 |
+```
|
|
177 |
+
|
|
178 |
+`r Biocpkg('ggtree')` supports creating phylomoji using Emoji fonts, please
|
|
179 |
+refer to `r CRANpkg("emojifont")` package vignette for details. The vignette can
|
|
180 |
+be opened via the following command:
|
|
181 |
+
|
|
182 |
+```r
|
|
183 |
+vignette("phylomoji", package="emojifont")
|
|
184 |
+```
|
132 |
185 |
|
133 |
|
-The `ggtree` package provides several layers to annotate a phylogenetic tree, including:
|
134 |
186 |
|
135 |
|
-+ `geom_cladelabel` for labelling selected clades
|
136 |
|
-+ `geom_hilight` for highlighting selected clades
|
137 |
|
-+ `geom_range` to indicate uncertainty of branch lengths
|
138 |
|
-+ `geom_strip` for adding strip/bar to label associated taxa (with optional label)
|
139 |
|
-+ `geom_taxalink` for connecting related taxa
|
140 |
|
-+ `geom_tiplab` for adding tip labels
|
141 |
|
-+ `geom_treescale` for adding a legend of tree scale
|
|
187 |
+`r Biocpkg('ggtree')` integrates [phylopic](http://phylopic.org/) database and silhouette images of organisms can
|
|
188 |
+be downloaded and used to annotate phylogenetic directly. `r Biocpkg('ggtree')` also supports
|
|
189 |
+using local or remote images to annotate a phylogenetic tree. For details,
|
|
190 |
+please refer to the `r CRANpkg('ggimage')` package vignette, which can be opened
|
|
191 |
+via the following command:
|
142 |
192 |
|
143 |
193 |
|
144 |
|
-It supports annotating phylogenetic trees with analyses obtained from R packages and other commonly used evolutionary software. User's specific annotation (e.g. experimental data) can be integrated to annotate phylogenetic trees. `ggtree` provides `write.jplace` function to combine Newick tree file and user's own data to a single `jplace` file that can be parsed and the data can be used to annotate the tree directly in `ggtree`.
|
|
194 |
+```r
|
|
195 |
+vignette("ggtree", package="ggimage")
|
|
196 |
+```
|
145 |
197 |
|
146 |
|
-`ggtree` integrates `phylopic` database and silhouette images of organisms can be downloaded and used to annotate phylogenetic directly. `ggtree` also supports using local images to annotate a phylogenetic tree.
|
147 |
198 |
|
148 |
|
-Visualizing an annotated phylogenetic tree with numerical matrix (e.g. genotype table), multiple sequence alignment and subplots are also supported in `ggtree`. Examples of annotating phylogenetic trees can be found in the [Tree Annotation](treeAnnotation.html) and [Advance Tree Annotation](advanceTreeAnnotation.html) vignettes.
|
|
199 |
+Visualizing an annotated phylogenetic tree with numerical matrix (e.g. genotype
|
|
200 |
+table), multiple sequence alignment and subplots are also supported in `ggtree`.
|
|
201 |
+Examples of annotating phylogenetic trees can be found in
|
|
202 |
+the [Tree Annotation](treeAnnotation.html) vignette.
|
149 |
203 |
|
150 |
204 |
|
151 |
205 |
# Vignette Entry
|
... |
... |
@@ -154,14 +208,13 @@ Visualizing an annotated phylogenetic tree with numerical matrix (e.g. genotype
|
154 |
208 |
+ [Tree Visualization](treeVisualization.html)
|
155 |
209 |
+ [Tree Manipulation](treeManipulation.html)
|
156 |
210 |
+ [Tree Annotation](treeAnnotation.html)
|
157 |
|
-+ [Advance Tree Annotation](advanceTreeAnnotation.html)
|
158 |
211 |
+ [Phylomoji](https://cran.r-project.org/web/packages/emojifont/vignettes/phylomoji.html)
|
159 |
|
-+ [Annotating phylogenetic tree with images using ggtree and ggimage](https://cran.r-project.org/web/packages/ggimage/vignettes/ggtree.html)
|
|
212 |
++ [Annotating phylogenetic tree with images](https://cran.r-project.org/web/packages/ggimage/vignettes/ggtree.html)
|
160 |
213 |
|
161 |
214 |
|
162 |
215 |
More documents can be found in <https://guangchuangyu.github.io/ggtree>.
|
163 |
216 |
|
164 |
|
-## Feedback ##
|
|
217 |
+# Feedback #
|
165 |
218 |
|
166 |
219 |
- For bugs or feature request, please post to [github issue](https://github.com/GuangchuangYu/ggtree/issues).
|
167 |
220 |
- For user questions, please post to [google group](https://groups.google.com/forum/#!forum/bioc-ggtree).
|