Package 'gggrid'

Title: Draw with 'grid' in 'ggplot2'
Description: An extension of 'ggplot2' that makes it easy to add raw 'grid' output, such as customised annotations, to a 'ggplot2' plot.
Authors: Paul Murrell [aut, cre]
Maintainer: Paul Murrell <[email protected]>
License: GPL-3
Version: 0.2-1
Built: 2024-11-02 02:41:12 UTC
Source: https://github.com/pmur002/gggrid

Help Index


Add a grid Layer.

Description

Adds a layer to a ggplot2 plot based on a raw grid grob or on a function that generates a 'grid' grob.

Usage

grid_panel(grob = nullGrob(),
           mapping = NULL, data = NULL, stat = "identity",
           position = "identity", inherit.aes = TRUE, 
           show.legend = FALSE, key_glyph = NULL,
           debug = NULL, ...)
grid_group(grob = nullGrob(),
           mapping = NULL, data = NULL, stat = "identity",
           position = "identity", inherit.aes = TRUE, 
           show.legend = FALSE, key_glyph = NULL, 
           debug = NULL, ...)

Arguments

grob

Either a grid grob or a function. The function must accept two arguments (data and coords) and must return a grid grob.

mapping, data, stat, position, inherit.aes

Standard arguments to a ggplot2 Geom.

debug

Either NULL or a function. The function must accept two arguments (data and coords) and will usually just print debugging output of some kind.

show.legend

Logical indicating whether grob should contribute to the legend.

key_glyph

A function to draw the key glyph in the legend.

...

Other arguments passed on to ggplot2::layer().

Details

The grid_panel() function will draw the grob, or call the grob function, once for each ggplot2 panel.

The grid_group() function will draw the grob, or call the grob function, once for each ggplot2 group.

Note

When adding a key_glyph, the call to grid_panel() or grid_group() must include an explicit mapping.

Author(s)

Paul Murrell

Examples

tg <- textGrob("label",
               x=unit(1, "npc") - unit(2, "mm"),
               y=unit(1, "npc") - unit(2, "mm"),
               just=c("right", "top"))
ggplot(mtcars) +
    geom_point(aes(disp, mpg)) +
    grid_panel(tg)