calc_dens_obs: Calculate and Combine Density Estimates for Observed and...

In dRiftDM: Estimating (Time-Dependent) Drift Diffusion Models

Calculate and Combine Density Estimates for Observed and Predicted Data

Description

Internal helper functions that return a data.frame summarizing density values for observed and predicted response times.

Usage

calc_dens_obs(
  rts_u,
  rts_l,
  one_cond,
  t_max = NULL,
  discr = NULL,
  scaling_factor = 1
)

calc_dens(
  pdf_u = NULL,
  pdf_l = NULL,
  t_vec = NULL,
  t_max = NULL,
  discr = NULL,
  rts_u = NULL,
  rts_l = NULL,
  one_cond,
  b_coding,
  scaling_factor = 1
)

Arguments

rts_u, rts_l	vectors of RTs for the upper and lower boundary
one_cond	character label
t_max	a single numeric value specifying the maximum RT to consider. Defaults to the smallest multiple of discr above the maximum RT. If t_vec is provided, t_max defaults to the maximum value of t_vec.
discr	a single numeric value defining the bin width for histogram and KDE estimation. Defaults to 0.015 (seconds).
scaling_factor	a single numeric value, multiplied with the PDFs. It is used to scale the corresponding probability mass proportional to the number of trials per condition. Defaults to 1.0.
pdf_u, pdf_l	density values for the upper and lower boundary
t_vec	the time space (required for the pdfs)
b_coding	used for accessing the upper/lower boundary labels, determines the corresponding columns of the returned data.frame (e.g., Quant_corr).

Details

calc_dens_obs() computes empirical histograms and kernel density estimates for a single condition based on observed RTs.

calc_dens() serves as a general interface that combines observed and predicted data into a single data.frame. Observed data (rts_u and rts_l) is passed to calc_dens_obs(). Predicted data (pdf_u and pdf_l) is wrapped into a data.frame that matches the structure returned by calc_dens_obs(). If both are provided, observed and predicted data are row-bound into a single data.frame.

These functions are used internally to support type = "density" in calc_stats(), providing a full distributional overview.

Value

A stats_dm object (via new_stats_dm()) containing a data.frame with columns:

• Source: indicates whether the row is from observed ("obs") or predicted ("pred") data.

• Cond: the condition label.

• Time: the time point corresponding to the density value.

• Stat: type of density summary—"hist" or "kde" (for observed data), or "pdf" (for predicted data).

• ⁠Dens_<U>⁠: density value for the upper response.

• ⁠Dens_<L>⁠: density value for the lower response.

The ⁠<U>⁠ and ⁠<L>⁠ placeholders are determined by the b_coding argument.

dRiftDM documentation built on Dec. 1, 2025, 5:08 p.m.