wrap_elements

A grob, ggplot, or ggassemble object to add to the
respective area.

panel, plot, full

Should the grobs be clipped if expanding outside its area

clip

Should tags be ignored for this cell. This is relevant when
using automatic tagging of plots and the content of the cell does not qualify
for a tag.

ignore_tag

In order to add non-ggplot2 element to a patchwork assemble they can be
converted to a compliant representation using the <code>wrap_elements()</code> function.
This allows you to position either grobs, ggplot objects, or ggassemble
objects in either the full area, the full plotting area (anything between and
including the axis label), or the panel area (only the actual area where data
is drawn). Further you can still add title, subtitle, tag, and caption using
the same approach as with normal ggplots (using
<a rd-options="ggplot2:ggtitle" href="/link/ggtitle()?package=patchwork&version=0.0.1&to=ggplot2%3Aggtitle" data-mini-rdoc="ggplot2:ggtitle::ggtitle()">ggtitle()</a> and <a rd-options="ggplot2:labs" href="/link/labs()?package=patchwork&version=0.0.1&to=ggplot2%3Alabs" data-mini-rdoc="ggplot2:labs::labs()">labs()</a>) as well as styling
using <a rd-options="ggplot2:theme" href="/link/theme()?package=patchwork&version=0.0.1&to=ggplot2%3Atheme" data-mini-rdoc="ggplot2:theme::theme()">theme()</a>. For the latter, only the theme elements
targeting plot margins and background as well as title, subtitle, etc styling
will have an effect. If a ggassemble or ggplot object is wrapped, it will be
fixated in its state and will no longer respond to addition of styling,
geoms, etc..

The 'ggplot2' package provides a strong API for sequentially
building up a plot, but does not concern itself with composition of multiple
plots. 'patchwork' is a package that expands the API to allow for
arbitrarily complex composition of plots by providing mathmatical operators
for combining multiple plots. Other packages that addresses this need (but
with a different approach) are 'gridExtra' and 'cowplot'.

Thomas Pedersen

patchwork

The Composer of ggplots

Thomas Lin Pedersen

wrap_elements function

In order to add non-ggplot2 element to a patchwork assemble they can be
converted to a compliant representation using the <code>wrap_elements()</code> function.
This allows you to position either grobs, ggplot objects, or ggassemble
objects in either the full area, the full plotting area (anything between and
including the axis label), or the panel area (only the actual area where data
is drawn). Further you can still add title, subtitle, tag, and caption using
the same approach as with normal ggplots (using
<a rd-options='ggplot2:ggtitle' href='ggtitle()'>ggtitle()</a> and <a rd-options='ggplot2:labs' href='labs()'>labs()</a>) as well as styling
using <a rd-options='ggplot2:theme' href='theme()'>theme()</a>. For the latter, only the theme elements
targeting plot margins and background as well as title, subtitle, etc styling
will have an effect. If a ggassemble or ggplot object is wrapped, it will be
fixated in its state and will no longer respond to addition of styling,
geoms, etc..

wrap_elements: Wrap arbitrary graphics in a patchwork-compliant cell

Description

Usage

Arguments

Value