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)