split_plot: Split plot into multiple subplots

In tidyplots: Tidy Plots for Scientific Papers

Split plot into multiple subplots

Description

Split plot into multiple subplots

Usage

split_plot(
  plot,
  by = NULL,
  rows = NULL,
  cols = NULL,
  ncol = NULL,
  nrow = NULL,
  axes = "all",
  axis.titles = "all",
  scales = NULL,
  ...
)

Arguments

plot	A tidyplot generated with the function tidyplot().
by	One variable that should be used for splitting.
rows, cols	Two variables that should be used for splitting, representing rows and columns, respectively.
ncol, nrow	The number of columns and rows per page. Only takes effect when using by to split by a single variable.
axes	Determines which axes will be drawn in case of fixed scales. When "margins", axes will be drawn at the exterior margins. "all_x" and "all_y" will draw the respective axes at the interior panels too, whereas "all" (the default) will draw all axes at all panels.
axis.titles	Determines which axis titles will be drawn. When "margins", axis titles will be drawn at the exterior margins. "all" (the default) will draw all axis titles at all panels. "single" will draw a single axis title per multiplot layout.
scales	Should scales be fixed "fixed", free ("free"), or free in one dimension ("free_x", "free_y")? Defaults to "free" when providing one splitting variable via by. Defaults to "fixed" when providing two splitting variables via rows and cols.
...	Arguments passed on to the geom function.

Value

A tidyplot object.

Examples

# Before splitting
energy |>
  dplyr::filter(year %in% c(2005, 2010, 2015, 2020)) |>
  tidyplot(y = energy, color = energy_source) |>
  add_donut() |>
  adjust_size(width = 25, height = 25)

# Split by year
energy |>
  dplyr::filter(year %in% c(2005, 2010, 2015, 2020)) |>
  tidyplot(y = energy, color = energy_source) |>
  add_donut() |>
  adjust_size(width = 25, height = 25) |>
  split_plot(by = year)

# Change dimensions of subplots
energy |>
  dplyr::filter(year %in% c(2005, 2010, 2015, 2020)) |>
  tidyplot(y = energy, color = energy_source) |>
  add_donut() |>
  adjust_size(width = 15, height = 15) |>
  split_plot(by = year)

# Spread plots across multiple pages
energy |>
  dplyr::filter(year %in% c(2005, 2010, 2015, 2020)) |>
  tidyplot(y = energy, color = energy_source) |>
  add_donut() |>
  adjust_size(width = 25, height = 25) |>
  split_plot(by = year, ncol = 2, nrow = 1)

# Split by two variables
energy |>
  dplyr::mutate(decade = paste0(floor(year / 10) * 10, "s")) |>
  tidyplot(y = energy, color = energy_source) |>
  add_donut() |>
  adjust_size(14,14) |>
  split_plot(rows = decade, cols = energy_type)

tidyplots documentation built on Jan. 8, 2026, 9:07 a.m.