plot.summary_irt_results: Plot Summary of IRT Simulation Results

In irtsim: Monte Carlo Simulation-Based Sample-Size Planning for Item Response Theory

Plot Summary of IRT Simulation Results

Description

Visualize performance criteria from a summary.irt_results() object. This is a convenience method for users who already have a summary; plot.irt_results() is the primary interface.

Usage

## S3 method for class 'summary_irt_results'
plot(x, criterion = "rmse", param = NULL, item = NULL, threshold = NULL, ...)

Arguments

x	A summary_irt_results object from summary.irt_results().
criterion	Character string. Which criterion to plot. Default "rmse".
param	Optional character vector. Filter to specific parameter types.
item	Optional integer vector. Filter to specific item numbers.
threshold	Optional numeric. If provided, draws a horizontal reference line at this value.
...	Additional arguments (ignored).

Value

A ggplot2::ggplot object, returned invisibly.

See Also

plot.irt_results(), summary.irt_results()

Examples

design <- irt_design(
  model = "1PL", n_items = 5,
  item_params = list(b = seq(-2, 2, length.out = 5))
)
study <- irt_study(design, sample_sizes = c(200, 500))
results <- irt_simulate(study, iterations = 10, seed = 42)
s <- summary(results)
plot(s, criterion = "rmse", threshold = 0.15)

irtsim documentation built on April 24, 2026, 1:07 a.m.