ggreveal (version 0.1.3)

reveal_x: Reveal plot by axis

Description

Turns a ggplot into a list of plots, showing data incrementally by the categories in the x or y axis.

Usage

reveal_x(p, order = NULL)
reveal_y(p, order = NULL)

Value

A list of ggplot2 objects, which can be passed to reveal_save()

Arguments

p

A ggplot2 object

order

(optional) A numeric vector specifying in which order to reveal the categories

For example, if there are three categories in the axis, order = c(3, 2, 1) will invert the order in which they are revealed.

Any category not included in the vector will be omitted from the incremental plots. E.g.: with order = c(3, 1), the second category is not shown.

By default, the first plot is blank, showing layout elements (title, legends, axes, etc) but no data. To omit the blank plot, include -1: e.g. order = c(-1, 3, 1), or order = -1.

Examples

# Create full plot
library(ggplot2)
data("mtcars")

p <- mtcars |>
  ggplot(aes(factor(vs), 
             color = gear,
             fill= gear, 
             group = gear)) +
  geom_bar() +
  facet_wrap(~am)
p

plot_list <- reveal_x(p)
plot_list[[1]]
plot_list[[2]]
plot_list[[3]]

# Save plots
reveal_save(plot_list, "myplot.png", width = 8, height = 4, path = tempdir())

# Clean temp files
file.remove(list.files(path = tempdir(), pattern = "myplot", full.names = TRUE))