Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ethanbass/ggtukey
Easily add compact letter display (i.e. "tukey letters") to ggplot figures
https://github.com/ethanbass/ggtukey
cld data-visualization ggplot-extension ggplot2 r r-package rstats
Last synced: 21 days ago
JSON representation
Easily add compact letter display (i.e. "tukey letters") to ggplot figures
- Host: GitHub
- URL: https://github.com/ethanbass/ggtukey
- Owner: ethanbass
- License: gpl-3.0
- Created: 2022-11-12T18:32:34.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-05-10T21:43:45.000Z (over 1 year ago)
- Last Synced: 2023-05-10T22:23:09.076Z (over 1 year ago)
- Topics: cld, data-visualization, ggplot-extension, ggplot2, r, r-package, rstats
- Language: R
- Homepage: https://ethanbass.github.io/ggtukey/
- Size: 20.5 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# ggtukey
[](https://ethanbass.r-universe.dev)
[](https://github.com/emersion/stability-badges#experimental)
# Introduction
This package provides a simple way to visualize paired comparisons by adding [compact letter displays](https://en.wikipedia.org/wiki/Compact_letter_display) (i.e. "Tukey letters") to 'ggplot2' figures.
# Installation
It is currently recommended to install `ggtukey` from GitHub:
```
install.packages("devtools")
devtools::install_github("https://github.com/ethanbass/ggtukey/")
```
or from [R Universe](https://ethanbass.r-universe.dev/):
```
install.packages("ggtukey", repos="https://ethanbass.r-universe.dev/", type="source")
```
# Usage
`ggtukey` provides a new geom (`geom_tukey`) for overlaying compact letter displays (CLDs) on ggplot figures.
```
library(ggtukey)
library(ggplot2)
data <- data.frame("Category" = c(rep("Low", 10), rep("Medium", 10), rep("High", 10)),
"Value" = c(rnorm(10, 5), rnorm(10, 5.5), rnorm(10, 10)),
"Size" = c("Big","Small"))
ggplot(data, aes(x=Category,y=Value)) +
geom_boxplot() +
facet_wrap(~Size) +
geom_tukey(hjust=-0.2,vjust=-0.2)
```
There is also a convenience function (`boxplot_letters`) for quickly producing these types of figures as shown below.
```
boxplot_letters(data, x=Category, y=Value, group=Size)
```
For more examples and details on different options for customization, please consult the package [documentation](https://ethanbass.github.io/ggtukey/reference/index.html) and [vignette](https://ethanbass.github.io/ggtukey/articles/ggtukey.html).
### Citation
You can cite `ggtukey` as follows:
Bass, E. (2022). ggtukey: Compact Letter Displays for 'ggplot2' (v0.4.0). (https://ethanbass.github.io/ggtukey/).
# Further Reading
Piepho, Hans-Peter. An Algorithm for a Letter-Based Representation of All-Pairwise Comparisons. Journal of Computational and Graphical Statistics 13, no. 2 (June 1, 2004): 456–66. https://doi.org/10.1198/1061860043515.
Piepho, Hans-Peter. “Letters in Mean Comparisons: What They Do and Don’t Mean.” Agronomy Journal 110, no. 2 (2018): 431–34. https://doi.org/10.2134/agronj2017.10.0580.
Graves S, Piepho H, Dorai-Raj LSwhfS (2019). multcompView: Visualizations of Paired Comparisons. R package version 0.1-8. https://CRAN.R-project.org/package=multcompView.