compute_dpp: Compute and Plot DPP

View source: R/dpp_functions.R

compute_dppR Documentation

Compute and Plot DPP

Description

Main wrapper function to compute and plot DPP analysis.

Usage

compute_dpp(
  data,
  lineup_size = 6,
  show_plot = TRUE,
  alpha = NULL,
  beta = NULL,
  innocent_suspect = "auto",
  ...
)

Arguments

data

Dataframe with standard lineup format

lineup_size

Integer. Lineup size (default = 6)

show_plot

Logical. Whether to display plot (default = TRUE)

alpha, beta

Optional Equation 3 weights; see make_dpp.

innocent_suspect

How innocent-suspect identifications in target-absent lineups are obtained. "designated": the lineups had a designated innocent suspect, so target-absent "suspect" rows are counted directly, and zero such rows means a false-ID rate of zero. "estimated": there was no designated innocent suspect, so the innocent-suspect count is estimated as filler IDs divided by lineup_size. "auto" (the default) chooses "designated" when any target-absent row is a suspect ID or the data have a non-missing suspect_pos column, and "estimated" otherwise, with a message.

...

Additional arguments passed to plot_dpp()

Value

An object of class "lineup_dpp": the make_dpp() result plus the plot.

Examples

data(lineup_example)
dpp_result <- compute_dpp(lineup_example, show_plot = FALSE)
print(dpp_result)


r4lineups documentation built on Nov. 10, 2026, 1:08 a.m.