Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marcboschmatas/ggspark
ggplot2 Functions to Create Tufte Style Sparklines
https://github.com/marcboschmatas/ggspark
Last synced: 3 days ago
JSON representation
ggplot2 Functions to Create Tufte Style Sparklines
- Host: GitHub
- URL: https://github.com/marcboschmatas/ggspark
- Owner: marcboschmatas
- Created: 2024-05-09T11:03:27.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2024-05-13T12:58:58.000Z (6 months ago)
- Last Synced: 2024-10-26T08:38:22.220Z (21 days ago)
- Language: R
- Size: 232 KB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.Rmd
Awesome Lists containing this project
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# ggspark
The goal of ggspark is to help create ggplot2 functions that help with creating sparkline plots in the style of Edward Tufte, such as this one
Thus, the package has two main functions: `stat_interquartilerange()` that draws a `geom_ribbon()` between the 1st and 3rd quartile of the variable in the y axis, and `stat_sparklabels()` that draws points or text labels in the beginning, min, max, and end points of the variable in the y axis.
## Installation
You can install the development version of ggspark like so:
``` r
devtools::install_github("marcboschmatas/ggspark")
```
## Example
The `stat_sparklabels()` function needs a colour scale with three values. The first one will be using for the start and end points of the line, the second one for the max, and the third one for the min.
```{r example}
library(ggplot2)
library(ggspark)
ggplot(airquality, aes(Day, Wind, group = Month)) +
stat_interquartilerange(geom = "ribbon",
show.legend = FALSE) +
geom_line() +
stat_sparklabels(geom = "label",
show.legend = FALSE) +
scale_colour_manual("", values = c("black", "blue", "red")) +
scale_y_continuous(limits = c(0, 25)) +
facet_grid(Month~.) +
ggtitle("Daily wind intensity by month in NYC") +
theme_minimal() +
theme(panel.grid = element_blank(),
axis.ticks = element_line())
```
It has an optional `label_fun` parameter that allows to modify the label aesthetics (such as rounding, adding percentage or currency suffixes and prefixes...).
```{r example2}
library(ggplot2)
library(ggspark)
ggplot(airquality, aes(Day, Wind, group = Month)) +
stat_interquartilerange(geom = "ribbon",
show.legend = FALSE) +
geom_line() +
stat_sparklabels(geom = "label", label_fun = \(x) round(x, 0),
show.legend = FALSE) +
scale_colour_manual("", values = c("black", "blue", "red")) +
scale_y_continuous(limits = c(0, 25)) +
facet_grid(Month~.) +
ggtitle("Daily wind intensity by month in NYC") +
theme_minimal() +
theme(panel.grid = element_blank(),
axis.ticks = element_line())
```
It is also possible to use points instead of labels.
```{r example3}
library(ggrepel)
ggplot(airquality, aes(Day, Wind, group = Month)) +
stat_interquartilerange(geom = "ribbon",
show.legend = FALSE) +
geom_line() +
stat_sparklabels(geom = "point",
show.legend = FALSE) +
scale_colour_manual("", values = c("black", "blue", "red")) +
scale_y_continuous(limits = c(0, 25)) +
facet_grid(Month~.) +
ggtitle("Daily wind intensity by month in NYC") +
theme_minimal() +
theme(panel.grid = element_blank(),
axis.ticks = element_line())
```
With ggrepel, it is possible to combine both text and dots.
```{r example4}
library(ggrepel)
ggplot(airquality, aes(Day, Wind, group = Month)) +
stat_interquartilerange(geom = "ribbon",
show.legend = FALSE) +
geom_line() +
stat_sparklabels(geom = "point", label_fun = \(x) round(x, 0),
show.legend = FALSE) +
stat_sparklabels(geom = "text_repel", label_fun = \(x) round(x, 0),
show.legend = FALSE) +
scale_colour_manual("", values = c("black", "blue", "red")) +
scale_y_continuous(limits = c(0, 25)) +
facet_grid(Month~.) +
ggtitle("Daily wind intensity by month in NYC") +
theme_minimal() +
theme(panel.grid = element_blank(),
axis.ticks = element_line())
```