R ggplot2 guide_bins Guide_legend 的分箱版本

本指南是分级尺度 guide_legend() 指南的一个版本。它的不同之处在于它在按键之间正确放置了刻度，并带有一个小轴以更好地显示分档。与 guide_legend() 一样，它可用于所有非位置美学，尽管颜色和填充默认为 guide_coloursteps() ，并且如果它们以相同的方式映射，它将把美学合并到同一指南中。

用法

guide_bins(
  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,
  keywidth = NULL,
  keyheight = NULL,
  axis = TRUE,
  axis.colour = "black",
  axis.linewidth = 0.5,
  axis.arrow = NULL,
  direction = NULL,
  default.unit = "line",
  override.aes = list(),
  reverse = FALSE,
  order = 0,
  show.limits = NULL,
  ...
)

参数

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

指定标签文本垂直对齐的数字。

keywidth

指定图例键宽度的数字或 grid::unit() 对象。默认值为theme()中的legend.key.width或legend.key.size。

keyheight

指定图例键高度的数字或 grid::unit() 对象。默认值为theme()中的legend.key.height或legend.key.size。

axis

逻辑性强。是否应该沿着导轨绘制小轴

axis.colour, axis.linewidth

轴外观的图形规范。

axis.arrow

调用 arrow() 以指定轴线末端的箭头，从而显示开区间。

direction

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

default.unit

对于keywidth和keyheight表示grid::unit()的字符串。

override.aes

指定图例键的美观参数的列表。请参阅详细信息和示例。

reverse

合乎逻辑的。如果TRUE，则图例的顺序相反。

order

小于 99 的正整数，指定该指南在多个指南中的顺序。这控制多个指南的显示顺序，而不是指南本身的内容。如果为 0(默认)，则顺序由秘密算法确定。

show.limits

逻辑性强。是否应该用标签和刻度显示刻度的限制。默认值为NULL，这意味着它将从刻度中获取值。如果 labels 作为值向量给出，则忽略此参数。如果 breaks 中也给出了一个或两个限制，则无论 show.limits 的值如何，都会显示该限制。

...

被忽略。

值

引导对象

与离散刻度一起使用

本指南旨在显示分箱数据并与 ggplot2 的分箱比例一起使用。然而，有时需要在单独的步骤中执行分箱，作为统计数据的一部分(例如 stat_contour_filled() )或在可视化之前。如果您想将本指南用于离散数据，则级别必须遵循 base::cut() 实现的命名方案。这意味着 bin 必须编码为 "(<lower>, <upper>]"，其中 <lower> 给出 bin 的下限，<upper> 给出上限(也接受 "[<lower>, <upper>)")。如果您使用 base::cut() 执行分箱，一切都应该按预期工作，如果没有，可能需要一些重新编码。

也可以看看

例子

p <- ggplot(mtcars) +
  geom_point(aes(disp, mpg, size = hp)) +
  scale_size_binned()

# Standard look
p


# Remove the axis or style it
p + guides(size = guide_bins(axis = FALSE))


p + guides(size = guide_bins(show.limits = TRUE))


p + guides(size = guide_bins(
  axis.arrow = arrow(length = unit(1.5, 'mm'), ends = 'both')
))


# Guides are merged together if possible
ggplot(mtcars) +
  geom_point(aes(disp, mpg, size = hp, colour = hp)) +
  scale_size_binned() +
  scale_colour_binned(guide = "bins")