<!-- 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 <https://yulab-smu.github.io/treedata-book/>. ## :writing\_hand: Authors Guangchuang YU School of Basic Medical Sciences, Southern Medical University <https://guangchuangyu.github.io> [](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) 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**^\*, TTY Lam, H Zhu, Y Guan^\*. 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). - [Source code to produce Supplementary Material](https://github.com/GuangchuangYu/plotting_tree_with_data) 2. **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. doi: [10.1111/2041-210X.12628](https://doi.org/10.1111/2041-210X.12628). <img src="https://guangchuangyu.github.io/software/citation_trend/ggtree.png" width="890"/> [](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/dlstats/ggtree.png" width="890"/> ## :sparkling\_heart: 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).