R ggplot2 guide_coloursteps 離散顏色條指南

本指南是用於分級顏色和填充比例的 guide_colourbar() 版本。它將中斷之間的區域顯示為單一恒定顏色，而不是從顏色條對應項中已知的漸變。

用法

guide_coloursteps(even.steps = TRUE, show.limits = NULL, ticks = FALSE, ...)

guide_colorsteps(even.steps = TRUE, show.limits = NULL, ticks = FALSE, ...)

參數

even.steps

箱的渲染大小應該相等，還是應該與其在數據空間中的長度成比例？默認為TRUE

show.limits

邏輯性強。是否應該用標簽和刻度顯示刻度的限製。默認值為NULL，這意味著它將從刻度中獲取值。如果 labels 作為值向量給出，則忽略此參數。如果 breaks 中也給出了一個或兩個限製，則無論 show.limits 的值如何，都會顯示該限製。

ticks

指定顏色條上的刻度線是否可見的邏輯。

...

參數傳遞給guide_colourbar

barwidth

指定顏色條寬度的數字或 grid::unit() 對象。默認值為theme() 或主題中的legend.key.width 或legend.key.size。

barheight

指定顏色條高度的數字或 grid::unit() 對象。默認值為theme() 或主題中的legend.key.height 或legend.key.size。

frame.colour

指定圍繞條繪製的框架顏色的字符串。如果NULL(默認值)，則不繪製框架。

frame.linewidth

一個數字，指定圍繞條繪製的框架的寬度(以毫米為單位)。

frame.linetype

一個數字，指定圍繞條繪製的框架的線型。

ticks.colour

指定刻度線顏色的字符串。

ticks.linewidth

指定刻度線寬度的數字(以毫米為單位)。

draw.ulim

指定上限刻度線是否可見的邏輯。

draw.llim

指定下限刻度線是否可見的邏輯。

direction

指示引導方向的字符串。 "horizontal" 或 "vertical." 之一

default.unit

對於barwidth和barheight表示grid::unit()的字符串。

reverse

合乎邏輯的。如果TRUE 則顏色條反轉。默認情況下，最高值位於頂部，最低值位於底部

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

指定標簽文本垂直對齊的數字。

order

小於 99 的正整數，指定該指南在多個指南中的順序。這控製多個指南的顯示順序，而不是指南本身的內容。如果為 0(默認)，則順序由秘密算法確定。

值

引導對象

與離散刻度一起使用

本指南旨在顯示分箱數據並與 ggplot2 的分箱比例一起使用。然而，有時需要在單獨的步驟中執行分箱，作為統計數據的一部分(例如 stat_contour_filled() )或在可視化之前。如果您想將本指南用於離散數據，則級別必須遵循 base::cut() 實現的命名方案。這意味著 bin 必須編碼為 "(<lower>, <upper>]"，其中 <lower> 給出 bin 的下限，<upper> 給出上限(也接受 "[<lower>, <upper>)")。如果您使用 base::cut() 執行分箱，一切都應該按預期工作，如果沒有，可能需要一些重新編碼。

也可以看看

例子

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

p <- ggplot(df, aes(X1, X2)) + geom_tile(aes(fill = value))

# Coloursteps guide is the default for binned colour scales
p + scale_fill_binned()


# By default each bin in the guide is the same size irrespectively of how
# their sizes relate in data space
p + scale_fill_binned(breaks = c(10, 25, 50))


# This can be changed with the `even.steps` argument
p + scale_fill_binned(
  breaks = c(10, 25, 50),
  guide = guide_coloursteps(even.steps = FALSE)
)


# By default the limits is not shown, but this can be changed
p + scale_fill_binned(guide = guide_coloursteps(show.limits = TRUE))


# (can also be set in the scale)
p + scale_fill_binned(show.limits = TRUE)