tidybayes (version 0.12.1.9000)

stat_pointinterval: Point estimate + multiple probability interval plots (ggplot stat)

Description

A combination of stat_summary / stat_summaryh and geom_pointinterval / geom_pointintervalh with sensible defaults. While the corresponding geoms are intended for use on data frames that have already been summarized using a point_interval function, these stats are intended for use directly on data frames of samples, and will perform the summarization using a point_interval function.

Usage

stat_pointinterval(mapping = NULL, data = NULL, geom = "pointinterval",
  position = "identity", ..., point_interval = median_qi, fun.data = NULL,
  .prob = c(0.66, 0.95), fun.args = list(), na.rm = FALSE,
  show.legend = FALSE, inherit.aes = TRUE)
stat_pointintervalh(mapping = NULL, data = NULL, geom = "pointintervalh",
  position = "identity", ..., point_interval = median_qi, fun.data = NULL,
  .prob = c(0.66, 0.95), fun.args = list(), na.rm = FALSE,
  show.legend = FALSE, inherit.aes = TRUE)

Arguments

mapping

The aesthetic mapping, usually constructed with aes or aes_string. Only needs to be set at the layer level if you are overriding the plot defaults.

data

A layer specific dataset - only needed if you want to override the plot defaults.

geom

Use to override the default connection between geom_pointinterval/geom_pointintervalh and stat_pointinterval/stat_pointintervalh.

position

The position adjustment to use for overlapping points on this layer.

...

Other arguments passed to layer. They may also be parameters to the paired geom.

point_interval

A function that when given a vector should return a data frame with variables y, ymin, ymax, and .prob; or x, xmin, xmax, and .prob. Either is acceptable: output will be converted into the y-based aesthetics for stat_pointinterval and the x-based aesthetics for stat_pointintervalh. See the point_interval family of functions.

fun.data

Similar to point_interval, for compatibility with stat_summary. Note: if the summary function is passed using fun.data, the x and y-based aesthetics are not converted to the correct form automatically.

.prob

The .prob argument passed to fun.data.

fun.args

Other optional arguments passed to fun.data.

na.rm

If FALSE, the default, missing values are removed with a warning. If TRUE, missing values are silently removed.

show.legend

Should this later be included in the legends? Default is FALSE, unlike most stats/geoms, to match its common use cases; N.B. this is unlike most geoms, which have a default of NA.

inherit.aes

If FALSE, overrides the default aesthetics, rather than combining with them. This is most useful for helper functions that define both data and aesthetics and shouldn't inherit behaviour from the default plot specification, e.g. borders.

See Also

See geom_pointinterval / geom_pointintervalh for the geom versions, intended for use on estimates and intervals that have already been summarized using a point_interval function. See stat_interval / stat_intervalh for a similar stat intended for intervals without point estimates.

Examples

# NOT RUN {
library(magrittr)
library(ggplot2)

data(RankCorr, package = "tidybayes")

RankCorr %>%
  spread_samples(u_tau[i]) %>%
  ggplot(aes(y = i, x = u_tau)) +
  stat_pointintervalh(.prob = c(.66, .95))

RankCorr %>%
  spread_samples(u_tau[i]) %>%
  ggplot(aes(x = i, y = u_tau)) +
  stat_pointinterval(.prob = c(.66, .95))

# }