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 包含一個簡單的示例。