descriptivesPlot: Descriptive plot of categorical variable (x-axis) vs. a...

In jasp-stats/jaspGraphs: Custom Graphs for JASP

Descriptive plot of categorical variable (x-axis) vs. a continuous variable (y-axis)

Description

Descriptive plot of categorical variable (x-axis) vs. a continuous variable (y-axis)

Usage

descriptivesPlot(
  x,
  y,
  ciLower = NULL,
  ciUpper = NULL,
  xName = NULL,
  yName = NULL,
  group = NULL,
  groupName = NULL,
  horizontalLine = NULL,
  horizontalLineLineType = "dashed",
  position = ggplot2::position_dodge(0.2),
  lineSize = 0.7,
  pointSize = 4,
  errorbarWidth = 0.2,
  noXLevelNames = length(x) == 1L,
  breaksAtExtremaOnly = TRUE,
  connectedPoints = TRUE,
  legendPosition = if (is.null(group)) "none" else "right"
)

Arguments

x	character vector indicating the groups shown on the x-axis.
y	numeric vector indicating the y-values.
ciLower	numeric vector with the lower bound of the confidence interval.
ciUpper	numeric vector with the upper bound of the confidence interval.
xName	character, name to use as the x-axis title.
yName	character, name to use as the y-axis title.
group	character vector indicating group membership, which is used for shape and fill color
groupName	character, name to show as the legend title.
horizontalLine	numeric, draw a horizontal asymptote at this y-value.
horizontalLineLineType	line type of the horizontal asymptote.
position	a value for the position argument of e.g., geom_line.
lineSize	a value for the size argument of geom_line.
pointSize	a value for the size argument of geom_point.
errorbarWidth	a value for the width argument of geom_errorbar.
noXLevelNames	Logical, should the level names on the x-axis be hidden?
breaksAtExtremaOnly	Logical, Should only the outermost y-axis breaks be shown?
connectedPoints	Logical, Should the dots be connected with lines?
legendPosition	Indicate the legend position (passed to theme).

Value

a ggplot2 object.

Examples

x <- "A"
y <- -0.188
ciLower <- y - .1
ciUpper <- y + .1
descriptivesPlot(x, y, ciLower, ciUpper, horizontalLine = -.1)


x <- c("Fast", "Slow")
y <- c(15, 22)
ciLower <- y - 3
ciUpper <- y + 3
xName <- "Condition"
yName <- "Response time"

descriptivesPlot(x, y, ciLower, ciUpper, xName, yName, horizontalLine = 18.5)

x <- c("0", "1", "0", "1")
y <- c(15, 22, 16, 21)
ciLower <- y - 3
ciUpper <- y + 3
xName <- "contBinom"
group <- c("m", "m", "f", "f")
groupName <- "facGender"
descriptivesPlot(x, y, ciLower, ciUpper, xName, group = group, groupName = groupName,
                 horizontalLine = 19)

set.seed(42)
kx <- 5
kg <- 20
n  <- kx * kg
x <- as.character(rep(1:kx, kg))
y <- rnorm(n, 10 + 10 * as.numeric(x), 2)
ciLower <- y - rnorm(n, 3 * as.numeric(x), 2)
ciUpper <- y + rnorm(n, 3 * as.numeric(x), 2)
group <- rep(seq_len(kg), each = kx)
xName <- "Groups"
yName <- "Performance"
groupName <- "Legend title"
descriptivesPlot(x, y, ciLower, ciUpper, xName, yName, group = group, groupName = groupName,
                 breaksAtExtremaOnly = FALSE, connectedPoints = FALSE)

jasp-stats/jaspGraphs documentation built on April 20, 2024, 4:13 p.m.