Grouped bar plot with optional significance annotations

Draws the mean of value per group with standard error bars, and adds pairwise significance labels when comparisons is supplied.

Usage

plot_barplot(
  value,
  group,
  comparisons = NULL,
  palette = "house",
  color = NULL,
  ylab = "Score",
  xlab = NULL,
  title = NULL,
  font = "Arial",
  label = "p.signif"
)

Arguments

value

Numeric values to summarise.

group

Grouping vector, one value per observation.

comparisons

Optional list of length-two vectors naming the groups to compare, for example list(c("A", "B")).

palette

Palette name passed to get_color().

color

Optional vector of fill colours; overrides palette.

ylab, xlab, title

Axis and plot labels.

font

Font family used in the plot.

label

Significance label style passed to ggpubr::stat_compare_means().

Value

A ggplot object.

Details

This function replaced the 0.1.0 plot_barplot(), which took no arguments and could not be called.

Examples

set.seed(1)
p <- plot_barplot(
  value = c(rnorm(20), rnorm(20, 1)),
  group = rep(c("A", "B"), each = 20)
)

if (requireNamespace("ggpubr", quietly = TRUE)) {
  p <- plot_barplot(
    value = c(rnorm(20), rnorm(20, 1), rnorm(20, 2)),
    group = rep(c("A", "B", "C"), each = 20),
    comparisons = list(c("A", "B"), c("B", "C"))
  )
}
#> `stat_compare_means()` with `comparisons` displays *unadjusted* p-values (no correction for multiple comparisons).
#> ℹ For p-values adjusted for multiple comparisons, use `geom_pwc()`, or `stat_pvalue_manual()` together with `compare_means(..., p.adjust.method = )`.
#> This message is displayed once per session.