score: Posterior draws of respondent proficiency

In measr: Bayesian Psychometric Measurement Using 'Stan'

Posterior draws of respondent proficiency

Description

Calculate posterior draws of respondent proficiency. Optionally retain all posterior draws or return only summaries of the distribution for each respondent.

Usage

score(
  x,
  newdata = NULL,
  missing = NA,
  identifier = NULL,
  summary = TRUE,
  probs = c(0.025, 0.975),
  force = FALSE
)

Arguments

x	An estimated model (e.g., from dcm_estimate().
newdata	Optional new data. If not provided, the data used to estimate the model is scored. If provided, newdata should be a data frame with 1 row per respondent and 1 column per item. All items that appear in newdata should appear in the data used to estimate x.
missing	An R expression specifying how missing data in data is coded (e.g., NA, ".", -99, etc.). The default is NA.
identifier	Optional. Variable name of a column in newdata that contains respondent identifiers. NULL (the default) indicates that no identifiers are present in the data, and row numbers will be used as identifiers. If newdata is not specified and the data used to estimate the model is scored, the resp_id is taken from the original data.
summary	Should summary statistics be returned instead of the raw posterior draws? Only relevant if the model was estimated with a method that results in posterior distributions (e.g., "mcmc", "variational"). Default is FALSE.
probs	The percentiles to be computed by the stats::quantile() function. Only relevant if the model was estimated with a method that results in posterior distributions (e.g., "mcmc", "variational"). Only used if summary is TRUE.
force	If respondent estimates have already been added to the model object with add_respondent_estimates(), should they be recalculated. Default is FALSE.

Value

A list with two elements: class_probabilities and attribute_probabilities.

If summary is FALSE, each element is a tibble with one row per respondent. The columns include the respondent identifier, and one column of probabilities for each of the possible classes or attributes (as posterior::rvar() objects).

If summary is TRUE, each element is a tibble with one row per respondent and class or attribute. The columns include the respondent identifier, class or attribute, mean, and one column for every value specified in probs.

Examples

rstn_mdm_lcdm <- dcm_estimate(
  dcm_specify(dcmdata::mdm_qmatrix, identifier = "item"),
  data = dcmdata::mdm_data,
  missing = NA,
  identifier = "respondent",
  method = "optim",
  seed = 63277,
  backend = "rstan"
)

score(rstn_mdm_lcdm, summary = FALSE)

measr documentation built on Jan. 14, 2026, 5:08 p.m.