---
output:
md_document:
variant: markdown_github
html_preview: false
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
# ggtree: an R package for visualization and annotation of phylogenetic trees with their covariates and other associated data
```{r echo=FALSE, results="hide", message=FALSE}
#library("txtplot")
library("badger")
library("ypages")
```
<img src="https://raw.githubusercontent.com/Bioconductor/BiocStickers/master/ggtree/ggtree.png" height="200" align="right" />
`r badge_bioc_release("ggtree", "green")`
`r badge_devel("guangchuangyu/ggtree", "green")`
[](https://www.bioconductor.org/packages/devel/bioc/html/ggtree.html#since)
[](https://awesome-r.com/#awesome-r-graphic-displays)
[](https://www.bioconductor.org/packages/devel/bioc/html/ggtree.html#archives)
[](http://www.repostatus.org/#active)
[](https://codecov.io/gh/GuangchuangYu/ggtree)
[)`-green.svg)](https://github.com/GuangchuangYu/ggtree/commits/master)
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.
For details, please visit our project website, <https://guangchuangyu.github.io/software/ggtree>.
+ [Documentation](https://guangchuangyu.github.io/software/ggtree/documentation/)
+ [FAQ](https://guangchuangyu.github.io/software/ggtree/faq/)
+ [Featured Articles](https://guangchuangyu.github.io/software/ggtree/featuredArticles/)
+ [Feedback](https://guangchuangyu.github.io/software/ggtree/#feedback)
[](https://twitter.com/intent/tweet?hashtags=ggtree&url=http://onlinelibrary.wiley.com/doi/10.1111/2041-210X.12628/abstract&screen_name=guangchuangyu)
[](https://saythanks.io/to/GuangchuangYu)
`r badger::badge_custom("follow me on", "微信", "green", "https://guangchuangyu.github.io/blog_images/biobabble.jpg")`
`r badger::badge_custom("打赏", "支付宝/微信", "green", "https://guangchuangyu.github.io/blog_images/pay_qrcode.png")`
-----------------------------------------------------
Please cite the following article when using `ggtree`:
__G Yu__, DK Smith, H Zhu, Y Guan, TTY Lam^\*^. ggtree: an R package for visualization and annotation of phylogenetic trees with their covariates and other associated data. __*Methods in Ecology and Evolution*__. 2017, 8(1):28-36.
`r badge_doi("10.1111/2041-210X.12628", "green")`
`r badge_altmetric("10533079", "green")`
----------------------------------------------------------------------------------------
### Citation
<img src="https://guangchuangyu.github.io/software/ggtree/featured-articles/index_files/figure-html/citation-1.png" width="890"/>
### Download stats
`r badge_download_bioc("ggtree")`
`r badge_bioc_download("ggtree", "total", "blue")`
`r badge_bioc_download("ggtree", "month", "blue")`
<img src="https://guangchuangyu.github.io/software/ggtree/index_files/figure-html/dlstats-1.png" width="890"/>
## Contributing
We welcome any contributions! By participating in this project you agree to
abide by the terms outlined in the [Contributor Code of Conduct](CONDUCT.md).