<!-- 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
<img src="https://raw.githubusercontent.com/Bioconductor/BiocStickers/master/ggtree/ggtree.png" height="200" align="right" />
[](https://www.bioconductor.org/packages/ggtree)
[](https://github.com/guangchuangyu/ggtree)
[](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)
[](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)
[](https://guangchuangyu.github.io/blog_images/biobabble.jpg)
[](https://guangchuangyu.github.io/blog_images/pay_qrcode.png)
-----
If you use [ggtree](http://bioconductor.org/packages/ggtree) in
published research, please cite the most appropriate paper(s) from this
list:
1. **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***. 2017, 8(1):28-36. doi:
[10.1111/2041-210X.12628](https://doi.org/10.1111/2041-210X.12628).
2. **G Yu**<sup>\*</sup>, TTY Lam, H Zhu, Y Guan<sup>\*</sup>. Two
methods for mapping and visualizing associated data on phylogeny
using ggtree. ***Molecular Biology and Evolution***, 2018,
35(2):3041-3043. doi:
[10.1093/molbev/msy194](https://doi.org/10.1093/molbev/msy194).
-----
## Authors
Guangchuang YU <https://guangchuangyu.github.io>
School of Basic Medical Sciences, Southern Medical
University
### Citation
<img src="https://guangchuangyu.github.io/software/ggtree/featured-articles/index_files/figure-html/citation-1.png" width="890"/>
### Download stats
[](https://bioconductor.org/packages/stats/bioc/ggtree)
[](https://bioconductor.org/packages/stats/bioc/ggtree)
[](https://bioconductor.org/packages/stats/bioc/ggtree)
<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).