R legendGrob 构建一个图例 Grob

说明

构建图例 grob(正在进行中)

用法

legendGrob(labels, nrow, ncol, byrow = FALSE,
           do.lines = has.lty || has.lwd, lines.first = TRUE,
           hgap = unit(1, "lines"), vgap = unit(1, "lines"),
           default.units = "lines", pch, gp = gpar(), vp = NULL)

grid.legend(..., draw=TRUE)

参数

labels	图例标签(表达式)
nrow, ncol	整数;图例 “layout” 的行数或列数。 nrow 是可选的，通常根据标签数量和 ncol 计算。
byrow	逻辑指示是否首先填充图例的行。
do.lines	逻辑指示是否绘制图例线。
lines.first	逻辑指示是否首先绘制图例行，因此在普通的 “below” 图例符号中绘制。
hgap	图例条目之间的水平间距
vgap	图例条目之间的垂直间距
default.units	默认单位，请参阅unit。
pch	图例符号，数字或字符，传递给 pointsGrob() ；另请参阅points 了解数字代码的解释。
gp	一个R类的对象"gpar"，通常是函数调用的输出gpar，本质上是图形参数设置的列表。
vp	网格 viewport 对象(或 NULL )。
...	对于 grid.legend() ：上面的所有参数都传递给 legendGrob() 。
draw	逻辑指示是否应产生图形输出。

值

这两个函数都会创建图例 grob (说明绘图图例的图形对象)，但只有 grid.legend 绘制它(仅当 draw 是 TRUE 时)。

例子

  ## Data:
  n <- 10
  x <- stats::runif(n) ; y1 <- stats::runif(n) ; y2 <- stats::runif(n)
  ## Construct the grobs :
  plot <- gTree(children=gList(rectGrob(),
                  pointsGrob(x, y1, pch=21, gp=gpar(col=2, fill="gray")),
                  pointsGrob(x, y2, pch=22, gp=gpar(col=3, fill="gray")),
                  xaxisGrob(),
                  yaxisGrob()))
  legd <- legendGrob(c("Girls", "Boys", "Other"), pch=21:23,
                     gp=gpar(col = 2:4, fill = "gray"))
  gg <- packGrob(packGrob(frameGrob(), plot),
                 legd, height=unit(1,"null"), side="right")

  ## Now draw it on a new device page:
  grid.newpage()
  pushViewport(viewport(width=0.8, height=0.8))
  grid.draw(gg)

也可以看看

Grid，viewport； pointsGrob、linesGrob。

grid.plot.and.legend 包含一个简单的示例。