The function insert_xaxis_grob() inserts a grob at the top or bottom of the plot panel in a ggplot2 plot.

insert_xaxis_grob(plot, grob, height = grid::unit(0.2, "null"),
  position = c("top", "bottom"))

insert_yaxis_grob(plot, grob, width = grid::unit(0.2, "null"),
  position = c("right", "left"))

Arguments

plot

The plot into which the grob will be inserted.

grob

The grob to insert. This will generally have been obtained via get_panel() from a ggplot2 object, in particular one generated with axis_canvas(). If a ggplot2 plot is provided instead of a grob, then get_panel() is called to extract the panel grob.

height

The height of the grob, in grid units. Used by insert_xaxis_grob().

position

The position of the grob. Can be "right" or "left" for insert_yaxis_grob() and "top" or "botton" for insert_xaxis_grob().

width

The width of the grob, in grid units. Used by insert_yaxis_grob().

Details

For usage examples, see axis_canvas().