Place a smaller plot (inset) at a specified position within the panel area
of a main plot, similar to patchwork::inset_element(). Coordinates
use normalized panel coordinates (0-1) by default.
Usage
grob_insert(
plot,
inset,
left = 0.6,
bottom = 0.6,
right = 1,
top = 1,
align_to = c("panel", "plot", "full"),
on_top = TRUE,
clip = TRUE
)Arguments
- plot
A
ggplotorpatchworkobject serving as the main plot.- inset
A
ggplot,grob, or other plot object to insert.- left
Left boundary of the inset (0 = panel left edge, 1 = right edge). Default is
0.6.- bottom
Bottom boundary of the inset (0 = panel bottom, 1 = top). Default is
0.6.- right
Right boundary of the inset. Default is
1.- top
Top boundary of the inset. Default is
1.- align_to
Reference area for positioning. One of
"panel"(default),"plot", or"full".- on_top
Logical. Whether the inset is drawn on top of the main plot. Default is
TRUE.- clip
Logical. Whether to clip the inset to the specified boundaries. Default is
TRUE.
Details
Unlike patchwork::inset_element(), this function returns a
ready-to-draw gtable object (use grid::grid.draw() to
render). It does not require patchwork and works with any grob-convertible
plot object.
See also
Other grob utilities:
grob_add(),
grob_as(),
grob_to_gg()
Examples
if (FALSE) { # \dontrun{
library(ggplot2)
main <- ggplot(mtcars, aes(wt, mpg)) + geom_point()
inset <- ggplot(mtcars, aes(factor(cyl))) + geom_bar() +
theme_void() + theme(plot.background = element_rect(fill = "white"))
gt <- grob_insert(main, inset,
left = 0.6, bottom = 0.6, right = 1, top = 1
)
grid::grid.draw(gt)
} # }