Plot accumulators and their timing relations — plot

Draw a schematic view of the model with time on the x-axis and evidence on the y-axis. Each accumulator is shown as a simple trajectory, and timing or blocking relations are overlaid so you can inspect the qualitative structure of the model before fitting.

Usage

plot_accumulators(
  model,
  xlim = NULL,
  ylim = c(0, 1),
  line_length = 1,
  angle_dodge = 10,
  accumulator_order = NULL,
  curve_strength = 0.18,
  line_col = "gray20",
  line_lwd = 3,
  axis_lwd = 3,
  blocker_lwd = 2.6,
  show_labels = TRUE,
  main = "Accumulator Schematic",
  xlab = "Time",
  ylab = "Evidence",
  ...
)

Arguments

model: A finalized model structure.
xlim: Optional x-axis limits. If NULL, they are chosen from the model.
ylim: Y-axis limits.
line_length: Length of each accumulator trajectory in plot units.
angle_dodge: Target angular spacing in degrees between neighbouring accumulators. Angles are centered at 45 degrees and constrained to 10 to 80 degrees. If there are too many accumulators sharing the same onset, spacing is reduced uniformly within that onset group.
accumulator_order: Optional character vector of accumulator labels, ordered from top-to-bottom. This only affects accumulators sharing the same onset.
curve_strength: Curvature applied to relationship arcs.
line_col: Color for accumulator trajectories.
line_lwd: Line width for accumulator trajectories.
axis_lwd: Line width for x/y axis arrows.
blocker_lwd: Line width for blocker arrows.
show_labels: If TRUE, add accumulator labels near the line endpoints.
main: Main title.
xlab: X-axis label.
ylab: Y-axis label.
...: Additional arguments passed to graphics::plot.

Value

Invisibly returns a list with plotting coordinates and inferred structural links.

Examples

spec <- race_spec() |>
  add_accumulator("go", "lognormal") |>
  add_accumulator("stop", "lognormal", onset = 0.15) |>
  add_pool("P", c("go", "stop")) |>
  add_outcome("R", "P") |>
  finalize_model()
plot_accumulators(spec)