multipage_facets

multipage_facets(
  gg,
  facet_by,
  ncol = NULL,
  nrow = NULL,
  byrow = NULL,
  widths = NULL,
  heights = NULL,
  guides = "collect",
  tag_level = NULL,
  design = NULL
)

Arguments

gg

A ggplot

facet_by

Variable that should be used for faceting.

ncol, nrow

The number of columns and rows per page.

byrow

Analogous to byrow in matrix(). If FALSE the plots will be filled in in column-major order

widths

The relative widths and heights of each column and row in the grid. Will get repeated to match the dimensions of the grid.

heights

The relative widths and heights of each column and row in the grid. Will get repeated to match the dimensions of the grid.

guides

A string specifying how guides should be treated in the layout. 'collect' will collect guides below to the given nesting level, removing duplicates. 'keep' will stop collection at this level and let guides be placed alongside their plot. auto will allow guides to be collected if a upper level tries, but place them alongside the plot if not.

tag_level

A string ('keep' or 'new') to indicate how auto-tagging should behave. See plot_annotation().

design

Specification of the location of areas in the layout. Can either be specified as a text string or by concatenating calls to area() together. See the examples for further information on use.