R ggplot2 guide_colourbar 連續色條指南

顏色條指南顯示映射到值的連續色標。顏色條可用於 scale_fill 和 scale_colour 。有關更多信息，請參閱此函數的靈感：Matlab's colorbar function。

用法

guide_colourbar(
  title = waiver(),
  title.position = NULL,
  title.theme = NULL,
  title.hjust = NULL,
  title.vjust = NULL,
  label = TRUE,
  label.position = NULL,
  label.theme = NULL,
  label.hjust = NULL,
  label.vjust = NULL,
  barwidth = NULL,
  barheight = NULL,
  nbin = 300,
  raster = TRUE,
  frame.colour = NULL,
  frame.linewidth = 0.5/.pt,
  frame.linetype = 1,
  ticks = TRUE,
  ticks.colour = "white",
  ticks.linewidth = 0.5/.pt,
  draw.ulim = TRUE,
  draw.llim = TRUE,
  direction = NULL,
  default.unit = "line",
  reverse = FALSE,
  order = 0,
  available_aes = c("colour", "color", "fill"),
  ...
)

guide_colorbar(
  title = waiver(),
  title.position = NULL,
  title.theme = NULL,
  title.hjust = NULL,
  title.vjust = NULL,
  label = TRUE,
  label.position = NULL,
  label.theme = NULL,
  label.hjust = NULL,
  label.vjust = NULL,
  barwidth = NULL,
  barheight = NULL,
  nbin = 300,
  raster = TRUE,
  frame.colour = NULL,
  frame.linewidth = 0.5/.pt,
  frame.linetype = 1,
  ticks = TRUE,
  ticks.colour = "white",
  ticks.linewidth = 0.5/.pt,
  draw.ulim = TRUE,
  draw.llim = TRUE,
  direction = NULL,
  default.unit = "line",
  reverse = FALSE,
  order = 0,
  available_aes = c("colour", "color", "fill"),
  ...
)

參數

title: 指示指南標題的字符串或表達式。如果是 NULL ，則不顯示標題。默認情況下 ( waiver() )，比例對象的名稱或 labs() 中指定的名稱用作標題。
title.position: 表示標題位置的字符串。 "top"(垂直參考線默認)、"bottom"、"left"(水平參考線默認)或 "right." 之一
title.theme: 用於渲染標題文本的主題對象。通常需要 element_text() 對象。默認情況下，主題由theme() 或主題中的legend.title 指定。
title.hjust: 指定標題文本的水平對齊方式的數字。
title.vjust: 指定標題文本垂直對齊的數字。
label: 合乎邏輯的。如果TRUE則繪製標簽。如果FALSE則標簽不可見。
label.position: 指示標簽位置的字符串。 "top"、"bottom"(水平參考線默認)、"left" 或 "right"(垂直參考線默認)之一。
label.theme: 用於渲染標簽文本的主題對象。通常需要 element_text() 對象。默認情況下，主題由 theme() 中的 legend.text 指定。
label.hjust: 指定標簽文本水平對齊的數字。對於表達式，標準文本的默認值是 0(左對齊)和 1(右對齊)。
label.vjust: 指定標簽文本垂直對齊的數字。
barwidth: 指定顏色條寬度的數字或 grid::unit() 對象。默認值為theme() 或主題中的legend.key.width 或legend.key.size。
barheight: 指定顏色條高度的數字或 grid::unit() 對象。默認值為theme() 或主題中的legend.key.height 或legend.key.size。
nbin: 一個數字，指定用於繪製顏色條的容器數。值越大，顏色條越平滑。
raster: 一個合乎邏輯的。如果TRUE，則顏色條將呈現為光柵對象。如果FALSE，則顏色條將呈現為一組矩形。請注意，並非所有圖形設備都能夠渲染光柵圖像。
frame.colour: 指定圍繞條繪製的框架顏色的字符串。如果NULL(默認值)，則不繪製框架。
frame.linewidth: 一個數字，指定圍繞條繪製的框架的寬度(以毫米為單位)。
frame.linetype: 一個數字，指定圍繞條繪製的框架的線型。
ticks: 指定顏色條上的刻度線是否可見的邏輯。
ticks.colour: 指定刻度線顏色的字符串。
ticks.linewidth: 指定刻度線寬度的數字(以毫米為單位)。
draw.ulim: 指定上限刻度線是否可見的邏輯。
draw.llim: 指定下限刻度線是否可見的邏輯。
direction: 指示引導方向的字符串。 "horizontal" 或 "vertical." 之一
default.unit: 對於barwidth和barheight表示grid::unit()的字符串。
reverse: 合乎邏輯的。如果TRUE 則顏色條反轉。默認情況下，最高值位於頂部，最低值位於底部
order: 小於 99 的正整數，指定該指南在多個指南中的順序。這控製多個指南的顯示順序，而不是指南本身的內容。如果為 0(默認)，則順序由秘密算法確定。
available_aes: 列出可以繪製顏色條的美學的字符串向量。
...: 被忽略。

值

引導對象

細節

可以在每個 scale_* 或 guides() 中指定指南。 scale_* 中的 guide="legend" 是 guide=guide_legend() 的語法糖(例如 scale_colour_manual(guide = "legend") )。至於如何更詳細地指定每個尺度的指南，請參見guides()。

也可以看看

其他指南：guide_bins()、guide_coloursteps()、guide_legend()、guides()

例子

df <- expand.grid(X1 = 1:10, X2 = 1:10)
df$value <- df$X1 * df$X2

p1 <- ggplot(df, aes(X1, X2)) + geom_tile(aes(fill = value))
p2 <- p1 + geom_point(aes(size = value))

# Basic form
p1 + scale_fill_continuous(guide = "colourbar")

p1 + scale_fill_continuous(guide = guide_colourbar())

p1 + guides(fill = guide_colourbar())


# Control styles

# bar size
p1 + guides(fill = guide_colourbar(barwidth = 0.5, barheight = 10))


# no label
p1 + guides(fill = guide_colourbar(label = FALSE))


# no tick marks
p1 + guides(fill = guide_colourbar(ticks = FALSE))


# label position
p1 + guides(fill = guide_colourbar(label.position = "left"))


# label theme
p1 + guides(fill = guide_colourbar(label.theme = element_text(colour = "blue", angle = 0)))


# small number of bins
p1 + guides(fill = guide_colourbar(nbin = 3))


# large number of bins
p1 + guides(fill = guide_colourbar(nbin = 100))


# make top- and bottom-most ticks invisible
p1 +
  scale_fill_continuous(
    limits = c(0,20), breaks = c(0, 5, 10, 15, 20),
    guide = guide_colourbar(nbin = 100, draw.ulim = FALSE, draw.llim = FALSE)
   )


# guides can be controlled independently
p2 +
  scale_fill_continuous(guide = "colourbar") +
  scale_size(guide = "legend")

p2 + guides(fill = "colourbar", size = "legend")


p2 +
  scale_fill_continuous(guide = guide_colourbar(direction = "horizontal")) +
  scale_size(guide = guide_legend(direction = "vertical"))

源代碼：R/guide-colorbar.R

相關用法

注：本文由純淨天空篩選整理自Hadley Wickham等大神的英文原創作品 Continuous colour bar guide。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。