R ggplot2 geom_ribbon 函数区和面积图

对于每个 x 值，geom_ribbon() 显示由 ymin 和 ymax 定义的 y 间隔。 geom_area() 是 geom_ribbon() 的特例，其中 ymin 固定为 0，并使用 y 代替 ymax 。

用法

geom_ribbon(
  mapping = NULL,
  data = NULL,
  stat = "identity",
  position = "identity",
  ...,
  na.rm = FALSE,
  orientation = NA,
  show.legend = NA,
  inherit.aes = TRUE,
  outline.type = "both"
)

geom_area(
  mapping = NULL,
  data = NULL,
  stat = "align",
  position = "stack",
  na.rm = FALSE,
  orientation = NA,
  show.legend = NA,
  inherit.aes = TRUE,
  ...,
  outline.type = "upper"
)

stat_align(
  mapping = NULL,
  data = NULL,
  geom = "area",
  position = "identity",
  ...,
  na.rm = FALSE,
  show.legend = NA,
  inherit.aes = TRUE
)

参数

mapping

由 aes() 创建的一组美学映射。如果指定且inherit.aes = TRUE(默认)，它将与绘图顶层的默认映射组合。如果没有绘图映射，则必须提供mapping。

data

该层要显示的数据。有以下三种选择：

如果默认为 NULL ，则数据继承自 ggplot() 调用中指定的绘图数据。

data.frame 或其他对象将覆盖绘图数据。所有对象都将被强化以生成 DataFrame 。请参阅fortify() 将为其创建变量。

将使用单个参数(绘图数据)调用function。返回值必须是 data.frame ，并将用作图层数据。可以从 formula 创建 function (例如 ~ head(.x, 10) )。

stat

用于该层数据的统计变换，可以作为 ggproto Geom 子类，也可以作为命名去掉 stat_ 前缀的统计数据的字符串(例如 "count" 而不是 "stat_count" )

position

位置调整，可以是命名调整的字符串(例如 "jitter" 使用 position_jitter )，也可以是调用位置调整函数的结果。如果需要更改调整设置，请使用后者。

...

其他参数传递给 layer() 。这些通常是美学，用于将美学设置为固定值，例如 colour = "red" 或 size = 3 。它们也可能是配对的 geom/stat 的参数。

na.rm

如果 FALSE ，则默认缺失值将被删除并带有警告。如果 TRUE ，缺失值将被静默删除。

orientation

层的方向。默认值 ( NA ) 自动根据美学映射确定方向。万一失败，可以通过将 orientation 设置为 "x" 或 "y" 来显式给出。有关更多详细信息，请参阅方向部分。

show.legend

合乎逻辑的。该层是否应该包含在图例中？ NA(默认值)包括是否映射了任何美学。 FALSE 从不包含，而 TRUE 始终包含。它也可以是一个命名的逻辑向量，以精细地选择要显示的美学。

inherit.aes

如果 FALSE ，则覆盖默认美学，而不是与它们组合。这对于定义数据和美观的辅助函数最有用，并且不应继承默认绘图规范的行为，例如borders() 。

outline.type

区域轮廓的类型； "both" 绘制上下两条线，"upper" /"lower" 仅绘制相应的线。 "full" 在该区域周围绘制一个闭合多边形。

geom

用于显示数据的几何对象，可以作为 ggproto Geom 子类，也可以作为命名去除 geom_ 前缀的几何对象的字符串(例如 "point" 而不是 "geom_point" )

细节

面积图是堆积条形图的连续模拟(请参阅 geom_bar() )，可用于显示整体的组成在 x 范围内如何变化。选择不同组件的堆叠顺序非常重要，因为当您向上移动堆栈时，越来越难以看到单个图案。有关堆叠算法的详细信息，请参阅position_stack()。为了便于堆叠，默认的 stat = "align" 将组插值到一组公共的 x 坐标。要关闭此插值，可以改用stat = "identity"。

方向

该几何体以不同的方式对待每个轴，因此可以有两个方向。通常，方向很容易从给定映射和使用的位置比例类型的组合中推断出来。因此，ggplot2 默认情况下会尝试猜测图层应具有哪个方向。在极少数情况下，方向不明确，猜测可能会失败。在这种情况下，可以直接使用 orientation 参数指定方向，该参数可以是 "x" 或 "y" 。该值给出了几何图形应沿着的轴，"x" 是您期望的几何图形的默认方向。

美学

geom_ribbon() 理解以下美学(所需的美学以粗体显示)：

• x 或者 y

• ymin 或者 xmin

• ymax 或者 xmax

• alpha

• colour

• fill

• group

• linetype

• linewidth

在 vignette("ggplot2-specs") 中了解有关设置这些美学的更多信息。

也可以看看

例子

# Generate data
huron <- data.frame(year = 1875:1972, level = as.vector(LakeHuron))
h <- ggplot(huron, aes(year))

h + geom_ribbon(aes(ymin=0, ymax=level))

h + geom_area(aes(y = level))


# Orientation cannot be deduced by mapping, so must be given explicitly for
# flipped orientation
h + geom_area(aes(x = level, y = year), orientation = "y")


# Add aesthetic mappings
h +
  geom_ribbon(aes(ymin = level - 1, ymax = level + 1), fill = "grey70") +
  geom_line(aes(y = level))


# The underlying stat_align() takes care of unaligned data points
df <- data.frame(
  g = c("a", "a", "a", "b", "b", "b"),
  x = c(1, 3, 5, 2, 4, 6),
  y = c(2, 5, 1, 3, 6, 7)
)
a <- ggplot(df, aes(x, y, fill = g)) +
  geom_area()

# Two groups have points on different X values.
a + geom_point(size = 8) + facet_grid(g ~ .)


# stat_align() interpolates and aligns the value so that the areas can stack
# properly.
a + geom_point(stat = "align", position = "stack", size = 8)


# To turn off the alignment, the stat can be set to "identity"
ggplot(df, aes(x, y, fill = g)) +
  geom_area(stat = "identity")