cowplot (version 0.5.0)

plot_grid: Arrange multiple plots into a grid

Description

Arrange multiple plots into a grid.

Usage

plot_grid(..., plotlist = NULL, align = c("none", "h", "v", "hv"),
  nrow = NULL, ncol = NULL, scale = 1, rel_widths = 1,
  rel_heights = 1, labels = NULL, label_size = 14, hjust = -0.5,
  vjust = 1.5, cols = NULL, rows = NULL)

Arguments

...

List of plots to be arranged into the grid. The plots can be either ggplot2 plot objects or arbitrary gtables.

plotlist

(optional) List of plots to display. Alternatively, the plots can be provided individually as the first n arguments of the function plot_grid (see examples).

align

(optional) Specifies whether graphs in the grid should be horizontally ("h") or vertically ("v") aligned. Options are "none" (default), "hv" (align in both directions), "h", and "v".

nrow

(optional) Number of rows in the plot grid.

ncol

(optional) Number of columns in the plot grid.

scale

(optional) Allows to set an overall scaling of each sub-plot. Can be set separately for each subplot, by giving a vector of scale values, or at once for all subplots, by giving a single value.

rel_widths

(optional) Numerical vector of relative columns widths. For example, in a two-column grid, rel_widths = c(2, 1) would make the first column twice as wide as the second column.

rel_heights

(optional) Numerical vector of relative columns heights. Works just as rel_widths does, but for rows rather than columns.

labels

(optional) List of labels to be added to the plots.

label_size

(optional) Numerical value indicating the label size. Default is 14.

hjust

Adjusts the horizontal position of each label. More negative values move the label further to the rigth on the plot canvas. Default is -0.5.

vjust

Adjusts the vertical position of each label. More positive values move the label further down on the plot canvas. Default is 1.5.

cols

Deprecated. Like ncol.

rows

Deprecated. Like nrow.

Examples

p1 <- qplot(1:10, 1:10)
p2 <- qplot(1:10, (1:10)^2)
p3 <- qplot(1:10, (1:10)^3)
p4 <- qplot(1:10, (1:10)^4)
# simple grid
plot_grid(p1, p2, p3, p4)
# simple grid with labels and aligned plots
plot_grid(p1, p2, p3, p4, labels=c('A', 'B', 'C', 'D'), align="hv")
# manually setting the number of rows
plot_grid(p1, p2, p3, nrow=3, labels=c('A', 'B', 'C', 'D'), label_size=12, align="v")
# missing plots in some grid locations
plot_grid(p1, NULL, NULL, p2, p3, NULL, ncol=2,
 labels=c('A', 'B', 'C', 'D', 'E', 'F'), label_size=12, align="v")
# making rows and columns of different widths/heights
plot_grid(p1, p2, p3, p4, align='hv', rel_heights=c(2,1), rel_widths=c(1,2))