Plot Caterpillar (Forest) Plot

Displays sorted point estimates with credible intervals for items or persons. Useful for identifying extreme values and assessing uncertainty. Requires ggplot2.

Usage

dpmirt_plot_caterpillar(
  fit,
  param = c("beta", "theta", "lambda", "delta"),
  sort = TRUE,
  ci_level = 0.95,
  max_show = 50,
  ...
)

Arguments

fit

A dpmirt_fit object from dpmirt.

param

Character. Parameter type: "beta" (default), "theta", "lambda", or "delta".

sort

Logical. Sort by estimate magnitude. Default TRUE.

ci_level

Numeric. Credible interval level. Default 0.95.

max_show

Integer. Maximum number of parameters to display. Default 50.

...

Currently unused.

Value

A ggplot object.

See also

plot.dpmirt_fit, dpmirt_plot_items

Other visualization: dpmirt_plot_clusters(), dpmirt_plot_density(), dpmirt_plot_density_compare(), dpmirt_plot_dp_density(), dpmirt_plot_icc(), dpmirt_plot_info(), dpmirt_plot_items(), dpmirt_plot_parameter_trace(), dpmirt_plot_pp_check(), dpmirt_plot_trace(), dpmirt_plot_wright_map(), plot.dpmirt_estimates(), plot.dpmirt_fit(), plot.dpmirt_sim()

Examples

if (FALSE) { # \dontrun{
sim <- dpmirt_simulate(200, 20, model = "rasch", seed = 42)
fit <- dpmirt(sim$response, model = "rasch", prior = "normal",
              niter = 5000, nburnin = 1000, seed = 123)
dpmirt_plot_caterpillar(fit, param = "beta")
} # }