Browse code

update faq

guangchuang yu authored on 08/12/2016 09:23:05
Showing 11 changed files

... ...
@@ -2,9 +2,9 @@
2 2
 ggtree: an R package for visualization and annotation of phylogenetic trees with their covariates and other associated data
3 3
 ===========================================================================================================================
4 4
 
5
-[![releaseVersion](https://img.shields.io/badge/release%20version-1.6.4-green.svg?style=flat)](https://bioconductor.org/packages/ggtree) [![develVersion](https://img.shields.io/badge/devel%20version-1.7.4-green.svg?style=flat)](https://github.com/GuangchuangYu/ggtree) [![Bioc](http://www.bioconductor.org/shields/years-in-bioc/ggtree.svg)](https://www.bioconductor.org/packages/devel/bioc/html/ggtree.html#since) [![total](https://img.shields.io/badge/downloads-16878/total-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree) [![month](https://img.shields.io/badge/downloads-1621/month-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree) <img src="logo.png" align="right" />
5
+[![releaseVersion](https://img.shields.io/badge/release%20version-1.6.4-green.svg?style=flat)](https://bioconductor.org/packages/ggtree) [![develVersion](https://img.shields.io/badge/devel%20version-1.7.4-green.svg?style=flat)](https://github.com/GuangchuangYu/ggtree) [![Bioc](http://www.bioconductor.org/shields/years-in-bioc/ggtree.svg)](https://www.bioconductor.org/packages/devel/bioc/html/ggtree.html#since) [![total](https://img.shields.io/badge/downloads-18149/total-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree) [![month](https://img.shields.io/badge/downloads-1852/month-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree) <img src="logo.png" align="right" />
6 6
 
7
-[![Project Status: Active - The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active) [![codecov](https://codecov.io/gh/GuangchuangYu/ggtree/branch/master/graph/badge.svg)](https://codecov.io/gh/GuangchuangYu/ggtree) [![Last-changedate](https://img.shields.io/badge/last%20change-2016--12--06-green.svg)](https://github.com/GuangchuangYu/ggtree/commits/master) [![GitHub forks](https://img.shields.io/github/forks/GuangchuangYu/ggtree.svg)](https://github.com/GuangchuangYu/ggtree/network) [![GitHub stars](https://img.shields.io/github/stars/GuangchuangYu/ggtree.svg)](https://github.com/GuangchuangYu/ggtree/stargazers) [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://awesome-r.com/#awesome-r-graphic-displays)
7
+[![Project Status: Active - The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active) [![codecov](https://codecov.io/gh/GuangchuangYu/ggtree/branch/master/graph/badge.svg)](https://codecov.io/gh/GuangchuangYu/ggtree) [![Last-changedate](https://img.shields.io/badge/last%20change-2016--12--08-green.svg)](https://github.com/GuangchuangYu/ggtree/commits/master) [![GitHub forks](https://img.shields.io/github/forks/GuangchuangYu/ggtree.svg)](https://github.com/GuangchuangYu/ggtree/network) [![GitHub stars](https://img.shields.io/github/stars/GuangchuangYu/ggtree.svg)](https://github.com/GuangchuangYu/ggtree/stargazers) [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://awesome-r.com/#awesome-r-graphic-displays)
8 8
 
9 9
 [![platform](http://www.bioconductor.org/shields/availability/devel/ggtree.svg)](https://www.bioconductor.org/packages/devel/bioc/html/ggtree.html#archives) [![Build Status](http://www.bioconductor.org/shields/build/devel/bioc/ggtree.svg)](https://bioconductor.org/checkResults/devel/bioc-LATEST/ggtree/) [![Linux/Mac Travis Build Status](https://img.shields.io/travis/GuangchuangYu/ggtree/master.svg?label=Mac%20OSX%20%26%20Linux)](https://travis-ci.org/GuangchuangYu/ggtree) [![AppVeyor Build Status](https://img.shields.io/appveyor/ci/Guangchuangyu/ggtree/master.svg?label=Windows)](https://ci.appveyor.com/project/GuangchuangYu/ggtree) [![install with bioconda](https://img.shields.io/badge/install%20with-bioconda-green.svg?style=flat)](http://bioconda.github.io/recipes/bioconductor-ggtree/README.html)
10 10
 
... ...
@@ -18,7 +18,7 @@ Please cite the following article when using `ggtree`:
18 18
 
19 19
 **G Yu**, DK Smith, H Zhu, Y Guan, TTY Lam<sup>\*</sup>. ggtree: an R package for visualization and annotation of phylogenetic trees with their covariates and other associated data. ***Methods in Ecology and Evolution***. *accepted*
20 20
 
21
-[![doi](https://img.shields.io/badge/doi-10.1111/2041--210X.12628-green.svg?style=flat)](http://dx.doi.org/10.1111/2041-210X.12628) [![citation](https://img.shields.io/badge/cited%20by-1-green.svg?style=flat)](https://scholar.google.com.hk/scholar?oi=bibs&hl=en&cites=7268358477862164627) [![Altmetric](https://img.shields.io/badge/Altmetric-284-green.svg?style=flat)](https://www.altmetric.com/details/10533079)
21
+[![doi](https://img.shields.io/badge/doi-10.1111/2041--210X.12628-green.svg?style=flat)](http://dx.doi.org/10.1111/2041-210X.12628) [![citation](https://img.shields.io/badge/cited%20by-1-green.svg?style=flat)](https://scholar.google.com.hk/scholar?oi=bibs&hl=en&cites=7268358477862164627) [![Altmetric](https://img.shields.io/badge/Altmetric-282-green.svg?style=flat)](https://www.altmetric.com/details/10533079)
22 22
 
23 23
 ------------------------------------------------------------------------
24 24
 
... ...
@@ -51,30 +51,30 @@ For details, please visit our project website, <https://guangchuangyu.github.io/
51 51
 
52 52
 ### Download stats
53 53
 
54
-[![download](http://www.bioconductor.org/shields/downloads/ggtree.svg)](https://bioconductor.org/packages/stats/bioc/ggtree) [![total](https://img.shields.io/badge/downloads-16878/total-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree) [![month](https://img.shields.io/badge/downloads-1621/month-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)
54
+[![download](http://www.bioconductor.org/shields/downloads/ggtree.svg)](https://bioconductor.org/packages/stats/bioc/ggtree) [![total](https://img.shields.io/badge/downloads-18149/total-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree) [![month](https://img.shields.io/badge/downloads-1852/month-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)
55 55
 
56
-         +------------------------+-----------------------+-----------------------+--------------------+
56
+         +----------------------+----------------------+----------------------+----------------------+-+
57
+         |                                                                                        *    |
58
+         |                                                                                             |
59
+         |                                                                                *            |
57 60
          |                                                                                    *        |
58
-         |                                                                                         *   |
59 61
     1500 +                                                                                             +
60 62
          |                                                                                             |
61 63
          |                                                                                             |
64
+         |                                                                    *                        |
65
+         |                                                         *                  *                |
66
+         |                                                                *       *                    |
67
+    1000 +                                                             *                               +
62 68
          |                                                                                             |
63
-         |                                                                        *                    |
64
-         |                                                            *                   *            |
65
-         |                                                                *   *       *                |
66
-    1000 +                                                                                             +
67
-         |                                                                                             |
68
-         |                                            *       *                                        |
69
-         |                                                        *                                    |
70
-         |                                    *   *       *                                            |
71
-         |                                                                                             |
72
-     500 +                                *                                                            +
73
-         |                                                                                             |
74
-         |                   *   *   *                                                                 |
69
+         |                                         *       *                                           |
70
+         |                                             *       *                                       |
71
+         |                                  *   *                                                      |
75 72
          |                                                                                             |
76
-         |               *                                                                             |
73
+     500 +                              *                                                              +
74
+         |                      *   *                                                                  |
75
+         |                  *                                                                          |
76
+         |              *                                                                              |
77 77
          |                                                                                             |
78 78
        0 +   *   *   *                                                                                 +
79
-         +------------------------+-----------------------+-----------------------+--------------------+
80
-       2015                    2015.5                   2016                   2016.5
79
+         +----------------------+----------------------+----------------------+----------------------+-+
80
+       2015                  2015.5                  2016                  2016.5                  2017
... ...
@@ -298,7 +298,8 @@ As these variable is not available in your <code>dataset</code>, you will get th
298 298
 <p>This can be fixed by using parameter <code>inherit.aes=FALSE</code> which will disable inheriting mapping from <code>ggtree</code> function.</p>
299 299
 <h1 id="annotation"><i class="fa fa-tree"></i> Annotation</h1>
300 300
 <h2 id="colouring-edges-by-user-data"><i class="fa fa-angle-double-right"></i> colouring edges by user data</h2>
301
-<p>see my answer on <a href="https://github.com/GuangchuangYu/ggtree/issues/76">https://github.com/GuangchuangYu/ggtree/issues/76</a>.</p></div>
301
+<p>see my answer on <a href="https://github.com/GuangchuangYu/ggtree/issues/76">https://github.com/GuangchuangYu/ggtree/issues/76</a>
302
+and <a href="https://groups.google.com/forum/#!topic/bioc-ggtree/4GgivKqVjB8">https://groups.google.com/forum/#!topic/bioc-ggtree/4GgivKqVjB8</a>.</p></div>
302 303
         </div>
303 304
 
304 305
         <footer class="col-md-12">
... ...
@@ -223,11 +223,11 @@
223 223
   }  
224 224
   </style>
225 225
 
226
-<div id = 'chart88f2cabace3' class = 'rChart morris'></div>
226
+<div id = 'chartf187d00a00e' class = 'rChart morris'></div>
227 227
 
228 228
 <script type='text/javascript'>
229 229
     var chartParams = {
230
- "element": "chart88f2cabace3",
230
+ "element": "chartf187d00a00e",
231 231
 "width":            800,
232 232
 "height":            400,
233 233
 "xkey": "year",
... ...
@@ -241,7 +241,7 @@
241 241
 "pubid": "HtEfBTGE9r8C" 
242 242
 } 
243 243
 ],
244
-"id": "chart88f2cabace3",
244
+"id": "chartf187d00a00e",
245 245
 "labels": "cites" 
246 246
 },
247 247
       chartType = "Bar"
... ...
@@ -236,9 +236,9 @@
236 236
 <p><img src="https://raw.githubusercontent.com/GuangchuangYu/ggtree/master/logo.png" align="right" /></p>
237 237
 <p><link rel="stylesheet" href="https://guangchuangyu.github.io/css/font-awesome.min.css"></p>
238 238
 <p><a href="https://bioconductor.org/packages/ggtree"><img alt="releaseVersion" src="https://img.shields.io/badge/release%20version-1.6.4-blue.svg?style=flat" /></a>
239
-<a href="https://github.com/GuangchuangYu/ggtree"><img alt="develVersion" src="https://img.shields.io/badge/devel%20version-1.7.3-blue.svg?style=flat" /></a>
240
-<a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img alt="total" src="https://img.shields.io/badge/downloads-16443/total-blue.svg?style=flat" /></a>
241
-<a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img alt="month" src="https://img.shields.io/badge/downloads-1621/month-blue.svg?style=flat" /></a></p>
239
+<a href="https://github.com/GuangchuangYu/ggtree"><img alt="develVersion" src="https://img.shields.io/badge/devel%20version-1.7.4-blue.svg?style=flat" /></a>
240
+<a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img alt="total" src="https://img.shields.io/badge/downloads-18149/total-blue.svg?style=flat" /></a>
241
+<a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img alt="month" src="https://img.shields.io/badge/downloads-1852/month-blue.svg?style=flat" /></a></p>
242 242
 <p>The <code>ggtree</code> package extending the <code>ggplot2</code> package. It based on grammar of graphics and takes all the good parts of <code>ggplot2</code>.  <code>ggtree</code> is designed for not only viewing phylogenetic tree but also displaying annotation data on the tree.
243 243
 <code>ggtree</code> is released within the <a href="https://bioconductor.org/packages/ggtree/">Bioconductor</a> project and the source code is hosted on <a href="https://github.com/GuangchuangYu/ggtree"><i class="fa fa-github fa-lg"></i> GitHub</a>.</p>
244 244
 <h2 id="authors"><i class="fa fa-user"></i> Authors</h2>
... ...
@@ -247,7 +247,7 @@
247 247
 <p>Please cite the following article when using <code>ggtree</code>:</p>
248 248
 <p><a href="http://dx.doi.org/10.1111/2041-210X.12628"><img alt="doi" src="https://img.shields.io/badge/doi-10.1111/2041--210X.12628-blue.svg?style=flat" /></a>
249 249
 <a href="https://scholar.google.com.hk/scholar?oi=bibs&amp;hl=en&amp;cites=7268358477862164627"><img alt="citation" src="https://img.shields.io/badge/cited%20by-1-blue.svg?style=flat" /></a>
250
-<a href="https://www.altmetric.com/details/10533079"><img alt="Altmetric" src="https://img.shields.io/badge/Altmetric-273-blue.svg?style=flat" /></a></p>
250
+<a href="https://www.altmetric.com/details/10533079"><img alt="Altmetric" src="https://img.shields.io/badge/Altmetric-282-blue.svg?style=flat" /></a></p>
251 251
 <p><strong>G Yu</strong>, DK Smith, H Zhu, Y Guan, TTY Lam<sup>*</sup>. ggtree: an R package for visualization and annotation of phylogenetic trees with their covariates and other associated data. <strong><em>Methods in Ecology and Evolution</em></strong>. <em>accepted</em>.</p>
252 252
 <h2 id="featured-articles"><i class="fa fa-pencil"></i> Featured Articles</h2>
253 253
 <p><img alt="" src="https://guangchuangyu.github.io/featured_img/ggtree/2015_peiyu_1-s2.0-S1567134815300721-gr1.jpg" /></p>
... ...
@@ -137,7 +137,7 @@
137 137
         }, 
138 138
         {
139 139
             "location": "/faq/", 
140
-            "text": "Installation\n\n\n Could not find function\n\n\nIf you got \nthis error\n, please make sure you are using the latest R and \nggtree\n.\n\n\nPackages in Bioconductor, like \nggtree\n, have different release policy compare to CRAN. There are two branches, release and devel, in parallel. Release branch is more stable and only document improvement and bug fixes will commit to it. New functions will only commit to \ndevel\n branch.\n\n\nSometimes I may write blog post to introduce new functions which is not available in \nrelease\n branch, you need to install the \ndevel\n version of \nggtree\n in order to use these new functions.\n\n\nYou can download the \ndevel\n version of \nggtree\n from \nhttp://bioconductor.org/packages/devel/bioc/html/ggtree.html\n and install it, or install the github version of \nggtree\n.\n\n\nThis also applied to other of my packages, including \nGOSemSim\n, \nDOSE\n, \nclusterProfiler\n, \nReactomePA\n and \nChIPseeker\n. If you got the \ncould not find function\n error, upgrade your installation to latest release. If the error still exists after upgrading to latest release, you need to install the devel version.\n\n\n Text \n Label\n\n\n Tip label truncated\n\n\nggplot2 can't auto adjust xlim based on added text.\n\n\nlibrary(ggtree)\n## example tree from https://support.bioconductor.org/p/72398/\ntree\n-read.tree(text=\n(Organism1.006G249400.1:0.03977,(Organism2.022118m:0.01337,(Organism3.J34265.1:0.00284,Organism4.G02633.1:0.00468)0.51:0.0104):0.02469);\n)\nggtree(tree) + geom_tiplab()\n\n\n\n\nThis is because the units are in two different spaces (data and pixel). Users can use xlim to allocate more space for tip label.\n\n\nggtree(tree) + geom_tiplab() + xlim(0, 0.06)\n\n\n\n\n Formatting (tip) labels\n\n\nIf you want to format labels, you need to set \nparse=TRUE\n in \ngeom_text\n/\ngeom_tiplab\n and the \nlabel\n should be string that can be parsed into expression and displayed as described in \n?plotmath\n.\n\n\nFor example, the tiplabels contains two parts, species name and accession number and we want to display species name in \nitalic\n, we can use command like this:\n\n\nggtree(rtree(30)) + geom_tiplab(aes(subset=node==35), label='paste(italic(\nspecies name\n), \naccession number\n)', parse=T)\n\n\n\n\n Avoid overlapping text labels\n\n\nUser can use \nggrepel\n package to repel overlapping text labels.\n\n\nFor example:\n\n\nlibrary(ggrepel)\nlibrary(ggtree)\nraxml_file \n- system.file(\nextdata/RAxML\n, \nRAxML_bipartitionsBranchLabels.H3\n, package=\nggtree\n)\nraxml \n- read.raxml(raxml_file)\nggtree(raxml) + geom_label_repel(aes(label=bootstrap, fill=bootstrap))\n\n\n\n\nFor details, please refer to \nggrepel usage examples\n.\n\n\n bootstrap values from newick format\n\n\nIt's quite command to store \nbootstrap\n value as node label in \nnewick\n format. Visualizing node label is easy using \ngeom_text2(aes(subset = !isTip, label=label))\n.\n\n\nIf you want to only display a subset of \nbootstrap\n (e.g. bootstrap \n 80), you can't simply using \ngeom_text2(subset= (label \n 80), label=label)\n since \nlabel\n is a character vector, which contains node label (bootstrap value) and tip label (taxa name). If we use \ngeom_text2(subset=(as.numeric(label) \n 80), label=label)\n, it will also fail since \nNAs\n were introduced by coercion. We need to convert \nNAs\n to logical \nFALSE\n, this can be done by the following code:\n\n\nnwk \n- system.file(\nextdata/RAxML\n,\nRAxML_bipartitions.H3\n, package='ggtree')\ntr \n- read.tree(nwk)\nggtree(tr) + geom_text2(aes(label=label, subset = !is.na(as.numeric(label)) \n as.numeric(label) \n 80))\n\n\n\n\nAnother solution is converting the bootstrap value outside \nggtree\n as I recommended in \ngoogle group\n.\n\n\nq \n- ggtree(tr)\nd \n- q$data\nd \n- d[!d$isTip,]\nd$label \n- as.numeric(d$label)\nd \n- d[d$label \n 80,]\n\nq + geom_text(data=d, aes(label=label))\n\n\n\n\n \naesthetic\n mapping\n\n\n inherit \naes\n\n\nggtree(rtree(30)) + geom_point()\n\n\n\n\nFor example, we can add symbolic points to nodes with \ngeom_point()\n directly.\nThe magic here is we don't need to map \nx\n and \ny\n position of the points by providing \naes(x, y)\n to \ngeom_point()\n since it was already mapped by \nggtree\n function and it serves as a global mapping for all layers.\n\n\nBut what if we provide a \ndataset\n in a layer and the \ndataset\n doesn't contain column of \nx\n and/or \ny\n,\nthe layer function also try to map \nx\n and \ny\n and also others if you map them in \nggtree\n function.\nAs these variable is not available in your \ndataset\n, you will get the following error:\n\n\nError in eval(expr, envir, enclos) : object 'x' not found\n\n\n\n\nThis can be fixed by using parameter \ninherit.aes=FALSE\n which will disable inheriting mapping from \nggtree\n function.\n\n\n Annotation\n\n\n colouring edges by user data\n\n\nsee my answer on \nhttps://github.com/GuangchuangYu/ggtree/issues/76\n.", 
140
+            "text": "Installation\n\n\n Could not find function\n\n\nIf you got \nthis error\n, please make sure you are using the latest R and \nggtree\n.\n\n\nPackages in Bioconductor, like \nggtree\n, have different release policy compare to CRAN. There are two branches, release and devel, in parallel. Release branch is more stable and only document improvement and bug fixes will commit to it. New functions will only commit to \ndevel\n branch.\n\n\nSometimes I may write blog post to introduce new functions which is not available in \nrelease\n branch, you need to install the \ndevel\n version of \nggtree\n in order to use these new functions.\n\n\nYou can download the \ndevel\n version of \nggtree\n from \nhttp://bioconductor.org/packages/devel/bioc/html/ggtree.html\n and install it, or install the github version of \nggtree\n.\n\n\nThis also applied to other of my packages, including \nGOSemSim\n, \nDOSE\n, \nclusterProfiler\n, \nReactomePA\n and \nChIPseeker\n. If you got the \ncould not find function\n error, upgrade your installation to latest release. If the error still exists after upgrading to latest release, you need to install the devel version.\n\n\n Text \n Label\n\n\n Tip label truncated\n\n\nggplot2 can't auto adjust xlim based on added text.\n\n\nlibrary(ggtree)\n## example tree from https://support.bioconductor.org/p/72398/\ntree\n-read.tree(text=\n(Organism1.006G249400.1:0.03977,(Organism2.022118m:0.01337,(Organism3.J34265.1:0.00284,Organism4.G02633.1:0.00468)0.51:0.0104):0.02469);\n)\nggtree(tree) + geom_tiplab()\n\n\n\n\nThis is because the units are in two different spaces (data and pixel). Users can use xlim to allocate more space for tip label.\n\n\nggtree(tree) + geom_tiplab() + xlim(0, 0.06)\n\n\n\n\n Formatting (tip) labels\n\n\nIf you want to format labels, you need to set \nparse=TRUE\n in \ngeom_text\n/\ngeom_tiplab\n and the \nlabel\n should be string that can be parsed into expression and displayed as described in \n?plotmath\n.\n\n\nFor example, the tiplabels contains two parts, species name and accession number and we want to display species name in \nitalic\n, we can use command like this:\n\n\nggtree(rtree(30)) + geom_tiplab(aes(subset=node==35), label='paste(italic(\nspecies name\n), \naccession number\n)', parse=T)\n\n\n\n\n Avoid overlapping text labels\n\n\nUser can use \nggrepel\n package to repel overlapping text labels.\n\n\nFor example:\n\n\nlibrary(ggrepel)\nlibrary(ggtree)\nraxml_file \n- system.file(\nextdata/RAxML\n, \nRAxML_bipartitionsBranchLabels.H3\n, package=\nggtree\n)\nraxml \n- read.raxml(raxml_file)\nggtree(raxml) + geom_label_repel(aes(label=bootstrap, fill=bootstrap))\n\n\n\n\nFor details, please refer to \nggrepel usage examples\n.\n\n\n bootstrap values from newick format\n\n\nIt's quite command to store \nbootstrap\n value as node label in \nnewick\n format. Visualizing node label is easy using \ngeom_text2(aes(subset = !isTip, label=label))\n.\n\n\nIf you want to only display a subset of \nbootstrap\n (e.g. bootstrap \n 80), you can't simply using \ngeom_text2(subset= (label \n 80), label=label)\n since \nlabel\n is a character vector, which contains node label (bootstrap value) and tip label (taxa name). If we use \ngeom_text2(subset=(as.numeric(label) \n 80), label=label)\n, it will also fail since \nNAs\n were introduced by coercion. We need to convert \nNAs\n to logical \nFALSE\n, this can be done by the following code:\n\n\nnwk \n- system.file(\nextdata/RAxML\n,\nRAxML_bipartitions.H3\n, package='ggtree')\ntr \n- read.tree(nwk)\nggtree(tr) + geom_text2(aes(label=label, subset = !is.na(as.numeric(label)) \n as.numeric(label) \n 80))\n\n\n\n\nAnother solution is converting the bootstrap value outside \nggtree\n as I recommended in \ngoogle group\n.\n\n\nq \n- ggtree(tr)\nd \n- q$data\nd \n- d[!d$isTip,]\nd$label \n- as.numeric(d$label)\nd \n- d[d$label \n 80,]\n\nq + geom_text(data=d, aes(label=label))\n\n\n\n\n \naesthetic\n mapping\n\n\n inherit \naes\n\n\nggtree(rtree(30)) + geom_point()\n\n\n\n\nFor example, we can add symbolic points to nodes with \ngeom_point()\n directly.\nThe magic here is we don't need to map \nx\n and \ny\n position of the points by providing \naes(x, y)\n to \ngeom_point()\n since it was already mapped by \nggtree\n function and it serves as a global mapping for all layers.\n\n\nBut what if we provide a \ndataset\n in a layer and the \ndataset\n doesn't contain column of \nx\n and/or \ny\n,\nthe layer function also try to map \nx\n and \ny\n and also others if you map them in \nggtree\n function.\nAs these variable is not available in your \ndataset\n, you will get the following error:\n\n\nError in eval(expr, envir, enclos) : object 'x' not found\n\n\n\n\nThis can be fixed by using parameter \ninherit.aes=FALSE\n which will disable inheriting mapping from \nggtree\n function.\n\n\n Annotation\n\n\n colouring edges by user data\n\n\nsee my answer on \nhttps://github.com/GuangchuangYu/ggtree/issues/76\n\nand \nhttps://groups.google.com/forum/#!topic/bioc-ggtree/4GgivKqVjB8\n.", 
141 141
             "title": "FAQ"
142 142
         }, 
143 143
         {
... ...
@@ -192,12 +192,12 @@
192 192
         }, 
193 193
         {
194 194
             "location": "/faq/#colouring-edges-by-user-data", 
195
-            "text": "see my answer on  https://github.com/GuangchuangYu/ggtree/issues/76 .", 
195
+            "text": "see my answer on  https://github.com/GuangchuangYu/ggtree/issues/76 \nand  https://groups.google.com/forum/#!topic/bioc-ggtree/4GgivKqVjB8 .", 
196 196
             "title": " colouring edges by user data"
197 197
         }, 
198 198
         {
199 199
             "location": "/featuredArticles/", 
200
-            "text": "Let us know\n if you have published using \nggtree\n and your publication will be featured here.\n\n\n\n\n\n\n\n\n\n\n\n\n\n  .rChart {\n    display: block;\n    margin-left: auto; \n    margin-right: auto;\n    width: 800px;\n    height: 300px;\n  }  \n  \n\n\n\n\n\n\n\n    var chartParams = {\n \"element\": \"chart88f2cabace3\",\n\"width\":            800,\n\"height\":            400,\n\"xkey\": \"year\",\n\"ykeys\": [\n \"cites\" \n],\n\"data\": [\n {\n \"year\": 2016,\n\"cites\":              1,\n\"pubid\": \"HtEfBTGE9r8C\" \n} \n],\n\"id\": \"chart88f2cabace3\",\n\"labels\": \"cites\" \n},\n      chartType = \"Bar\"\n    new Morris[chartType](chartParams)\n\n\n\n\n 2016\n\n\nLack of GLYCOLATE OXIDASE 1, but not GLYCOLATE OXIDASE 2, attenuates the photorespiratory phenotype of CATALASE2-deficient \nArabidopsis\n\n\nPlant Physiology\n May. 2016 \n\n\n\n\nRange overlap drives chromosome inversion fixation in passerine birds\n\n\nbioRxiv\n May. 2016 \nhttp://dx.doi.org/10.1101/053371\n\n\n\n\nPhenotypic and Genotypic Characteristics of Shiga Toxin-Producing Escherichia coli Isolated from Surface Waters and Sediments in a Canadian Urban-Agricultural Landscape\n\n\nFront. Cell. Infect. Microbiol.\n Apr. 2016 \nhttp://dx.doi.org/10.3389%2Ffcimb.2016.00036\n\n\n\n\nWs-2\n Introgression in a Proportion of \nArabidopsis thaliana Col-0\n Stock Seed Produces Specific Phenotypes and Highlights the Importance of Routine Genetic Verification\n\n\nPlant Cell\n Mar. 2016 \nhttp://dx.doi.org/10.1105/tpc.16.00053\n\n\n\n\n 2015\n\n\nThe population genetics of drug resistance evolution in natural populations of viral, bacterial and eukaryotic pathogens\n\n\nMolecuar Ecology\n Dec. 2015 \nhttp://dx.doi.org/10.1111/mec.13474\n\n\n\n\nGenetic characterization of highly pathogenic H5 influenza viruses from poultry in Taiwan, 2015\n\n\nInfection, Genetics and Evolution\n Dec. 2015 \nhttp://dx.doi.org/10.1016/j.meegid.2015.12.006\n\n\n\n\nTrans-species polymorphism at antimicrobial innate immunity cathelicidin genes of Atlantic cod and related species\n\n\nPeerJ\n May 2015 \nhttps://doi.org/10.7717/peerj.976", 
200
+            "text": "Let us know\n if you have published using \nggtree\n and your publication will be featured here.\n\n\n\n\n\n\n\n\n\n\n\n\n\n  .rChart {\n    display: block;\n    margin-left: auto; \n    margin-right: auto;\n    width: 800px;\n    height: 300px;\n  }  \n  \n\n\n\n\n\n\n\n    var chartParams = {\n \"element\": \"chartf187d00a00e\",\n\"width\":            800,\n\"height\":            400,\n\"xkey\": \"year\",\n\"ykeys\": [\n \"cites\" \n],\n\"data\": [\n {\n \"year\": 2016,\n\"cites\":              1,\n\"pubid\": \"HtEfBTGE9r8C\" \n} \n],\n\"id\": \"chartf187d00a00e\",\n\"labels\": \"cites\" \n},\n      chartType = \"Bar\"\n    new Morris[chartType](chartParams)\n\n\n\n\n 2016\n\n\nLack of GLYCOLATE OXIDASE 1, but not GLYCOLATE OXIDASE 2, attenuates the photorespiratory phenotype of CATALASE2-deficient \nArabidopsis\n\n\nPlant Physiology\n May. 2016 \n\n\n\n\nRange overlap drives chromosome inversion fixation in passerine birds\n\n\nbioRxiv\n May. 2016 \nhttp://dx.doi.org/10.1101/053371\n\n\n\n\nPhenotypic and Genotypic Characteristics of Shiga Toxin-Producing Escherichia coli Isolated from Surface Waters and Sediments in a Canadian Urban-Agricultural Landscape\n\n\nFront. Cell. Infect. Microbiol.\n Apr. 2016 \nhttp://dx.doi.org/10.3389%2Ffcimb.2016.00036\n\n\n\n\nWs-2\n Introgression in a Proportion of \nArabidopsis thaliana Col-0\n Stock Seed Produces Specific Phenotypes and Highlights the Importance of Routine Genetic Verification\n\n\nPlant Cell\n Mar. 2016 \nhttp://dx.doi.org/10.1105/tpc.16.00053\n\n\n\n\n 2015\n\n\nThe population genetics of drug resistance evolution in natural populations of viral, bacterial and eukaryotic pathogens\n\n\nMolecuar Ecology\n Dec. 2015 \nhttp://dx.doi.org/10.1111/mec.13474\n\n\n\n\nGenetic characterization of highly pathogenic H5 influenza viruses from poultry in Taiwan, 2015\n\n\nInfection, Genetics and Evolution\n Dec. 2015 \nhttp://dx.doi.org/10.1016/j.meegid.2015.12.006\n\n\n\n\nTrans-species polymorphism at antimicrobial innate immunity cathelicidin genes of Atlantic cod and related species\n\n\nPeerJ\n May 2015 \nhttps://doi.org/10.7717/peerj.976", 
201 201
             "title": "Featured Articles"
202 202
         }, 
203 203
         {
... ...
@@ -4,7 +4,7 @@
4 4
     
5 5
     <url>
6 6
      <loc>https://guangchuangyu.github.io/ggtree/</loc>
7
-     <lastmod>2016-11-16</lastmod>
7
+     <lastmod>2016-12-08</lastmod>
8 8
      <changefreq>daily</changefreq>
9 9
     </url>
10 10
     
... ...
@@ -12,7 +12,7 @@
12 12
     
13 13
     <url>
14 14
      <loc>https://guangchuangyu.github.io/ggtree/documentation/</loc>
15
-     <lastmod>2016-11-16</lastmod>
15
+     <lastmod>2016-12-08</lastmod>
16 16
      <changefreq>daily</changefreq>
17 17
     </url>
18 18
     
... ...
@@ -20,7 +20,7 @@
20 20
     
21 21
     <url>
22 22
      <loc>https://guangchuangyu.github.io/ggtree/faq/</loc>
23
-     <lastmod>2016-11-16</lastmod>
23
+     <lastmod>2016-12-08</lastmod>
24 24
      <changefreq>daily</changefreq>
25 25
     </url>
26 26
     
... ...
@@ -28,7 +28,7 @@
28 28
     
29 29
     <url>
30 30
      <loc>https://guangchuangyu.github.io/ggtree/featuredArticles/</loc>
31
-     <lastmod>2016-11-16</lastmod>
31
+     <lastmod>2016-12-08</lastmod>
32 32
      <changefreq>daily</changefreq>
33 33
     </url>
34 34
     
... ...
@@ -37,49 +37,49 @@
37 37
         
38 38
     <url>
39 39
      <loc>https://guangchuangyu.github.io/ggtree/ChIPseeker/</loc>
40
-     <lastmod>2016-11-16</lastmod>
40
+     <lastmod>2016-12-08</lastmod>
41 41
      <changefreq>daily</changefreq>
42 42
     </url>
43 43
         
44 44
     <url>
45 45
      <loc>https://guangchuangyu.github.io/ggtree/clusterProfiler/</loc>
46
-     <lastmod>2016-11-16</lastmod>
46
+     <lastmod>2016-12-08</lastmod>
47 47
      <changefreq>daily</changefreq>
48 48
     </url>
49 49
         
50 50
     <url>
51 51
      <loc>https://guangchuangyu.github.io/ggtree/DOSE/</loc>
52
-     <lastmod>2016-11-16</lastmod>
52
+     <lastmod>2016-12-08</lastmod>
53 53
      <changefreq>daily</changefreq>
54 54
     </url>
55 55
         
56 56
     <url>
57 57
      <loc>https://guangchuangyu.github.io/ggtree/emojifont/</loc>
58
-     <lastmod>2016-11-16</lastmod>
58
+     <lastmod>2016-12-08</lastmod>
59 59
      <changefreq>daily</changefreq>
60 60
     </url>
61 61
         
62 62
     <url>
63 63
      <loc>https://guangchuangyu.github.io/ggtree/ggtree/</loc>
64
-     <lastmod>2016-11-16</lastmod>
64
+     <lastmod>2016-12-08</lastmod>
65 65
      <changefreq>daily</changefreq>
66 66
     </url>
67 67
         
68 68
     <url>
69 69
      <loc>https://guangchuangyu.github.io/ggtree/GOSemSim/</loc>
70
-     <lastmod>2016-11-16</lastmod>
70
+     <lastmod>2016-12-08</lastmod>
71 71
      <changefreq>daily</changefreq>
72 72
     </url>
73 73
         
74 74
     <url>
75 75
      <loc>https://guangchuangyu.github.io/ggtree/meshes/</loc>
76
-     <lastmod>2016-11-16</lastmod>
76
+     <lastmod>2016-12-08</lastmod>
77 77
      <changefreq>daily</changefreq>
78 78
     </url>
79 79
         
80 80
     <url>
81 81
      <loc>https://guangchuangyu.github.io/ggtree/ReactomePA/</loc>
82
-     <lastmod>2016-11-16</lastmod>
82
+     <lastmod>2016-12-08</lastmod>
83 83
      <changefreq>daily</changefreq>
84 84
     </url>
85 85
         
... ...
@@ -7,6 +7,7 @@
7 7
 \alias{get.tree,beast}
8 8
 \alias{get.tree,codeml-method}
9 9
 \alias{get.tree,codeml_mlc-method}
10
+\alias{get.tree,data.frame-method}
10 11
 \alias{get.tree,hyphy-method}
11 12
 \alias{get.tree,jplace-method}
12 13
 \alias{get.tree,nhx-method}
... ...
@@ -40,6 +41,8 @@ get.tree(object, ...)
40 41
 
41 42
 \S4method{get.tree}{phylo}(object, ...)
42 43
 
44
+\S4method{get.tree}{data.frame}(object, ...)
45
+
43 46
 \S4method{get.tree}{paml_rst}(object)
44 47
 
45 48
 \S4method{get.tree}{phangorn}(object, ...)
... ...
@@ -127,4 +127,5 @@ This can be fixed by using parameter `inherit.aes=FALSE` which will disable inhe
127 127
 
128 128
 ## <i class="fa fa-angle-double-right"></i> colouring edges by user data
129 129
 
130
-see my answer on <https://github.com/GuangchuangYu/ggtree/issues/76>.
130
+see my answer on <https://github.com/GuangchuangYu/ggtree/issues/76>
131
+and <https://groups.google.com/forum/#!topic/bioc-ggtree/4GgivKqVjB8>.
... ...
@@ -36,10 +36,10 @@
36 36
   }  
37 37
   </style>
38 38
 
39
-<div id = 'chart88f2cabace3' class = 'rChart morris'></div>
39
+<div id = 'chartf187d00a00e' class = 'rChart morris'></div>
40 40
 <script type='text/javascript'>
41 41
     var chartParams = {
42
- "element": "chart88f2cabace3",
42
+ "element": "chartf187d00a00e",
43 43
 "width":            800,
44 44
 "height":            400,
45 45
 "xkey": "year",
... ...
@@ -53,7 +53,7 @@
53 53
 "pubid": "HtEfBTGE9r8C" 
54 54
 } 
55 55
 ],
56
-"id": "chart88f2cabace3",
56
+"id": "chartf187d00a00e",
57 57
 "labels": "cites" 
58 58
 },
59 59
       chartType = "Bar"
... ...
@@ -17,9 +17,9 @@
17 17
 <link rel="stylesheet" href="https://guangchuangyu.github.io/css/font-awesome.min.css">
18 18
 
19 19
 [![releaseVersion](https://img.shields.io/badge/release%20version-1.6.4-blue.svg?style=flat)](https://bioconductor.org/packages/ggtree)
20
-[![develVersion](https://img.shields.io/badge/devel%20version-1.7.3-blue.svg?style=flat)](https://github.com/GuangchuangYu/ggtree)
21
-[![total](https://img.shields.io/badge/downloads-16443/total-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)
22
-[![month](https://img.shields.io/badge/downloads-1621/month-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)
20
+[![develVersion](https://img.shields.io/badge/devel%20version-1.7.4-blue.svg?style=flat)](https://github.com/GuangchuangYu/ggtree)
21
+[![total](https://img.shields.io/badge/downloads-18149/total-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)
22
+[![month](https://img.shields.io/badge/downloads-1852/month-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)
23 23
 
24 24
 
25 25
 The `ggtree` package extending the `ggplot2` package. It based on grammar of graphics and takes all the good parts of `ggplot2`.  `ggtree` is designed for not only viewing phylogenetic tree but also displaying annotation data on the tree.
... ...
@@ -36,7 +36,7 @@ Please cite the following article when using `ggtree`:
36 36
 
37 37
 [![doi](https://img.shields.io/badge/doi-10.1111/2041--210X.12628-blue.svg?style=flat)](http://dx.doi.org/10.1111/2041-210X.12628)
38 38
 [![citation](https://img.shields.io/badge/cited%20by-1-blue.svg?style=flat)](https://scholar.google.com.hk/scholar?oi=bibs&hl=en&cites=7268358477862164627)
39
-[![Altmetric](https://img.shields.io/badge/Altmetric-273-blue.svg?style=flat)](https://www.altmetric.com/details/10533079)
39
+[![Altmetric](https://img.shields.io/badge/Altmetric-282-blue.svg?style=flat)](https://www.altmetric.com/details/10533079)
40 40
 
41 41
 __G Yu__, DK Smith, H Zhu, Y Guan, TTY Lam<sup>\*</sup>. ggtree: an R package for visualization and annotation of phylogenetic trees with their covariates and other associated data. __*Methods in Ecology and Evolution*__. *accepted*.
42 42
 
... ...
@@ -114,4 +114,5 @@ This can be fixed by using parameter `inherit.aes=FALSE` which will disable inhe
114 114
 
115 115
 ## <i class="fa fa-angle-double-right"></i> colouring edges by user data
116 116
 
117
-see my answer on <https://github.com/GuangchuangYu/ggtree/issues/76>.
117
+see my answer on <https://github.com/GuangchuangYu/ggtree/issues/76>
118
+and <https://groups.google.com/forum/#!topic/bioc-ggtree/4GgivKqVjB8>.