Plot design-weighted precision curves

Visualize the design-weighted precision curve and optionally per-facet-level contribution curves from compute_information().

Usage

plot_information(
  x,
  type = c("tif", "iif", "se", "sem", "csem", "both"),
  facet = NULL,
  draw = TRUE,
  ...
)

Arguments

x: Output from compute_information().
type: "tif" for the overall precision curve (default), "iif" for facet-level contribution curves, "se" / "sem" / "csem" for the conditional standard error of measurement implied by that curve, or "both" for precision and conditional SEM in separate panels.
facet: For type = "iif", which facet to plot. If NULL, the first facet is used.
draw: If TRUE (default), draw the plot. If FALSE, return the ggplot object invisibly without printing.
...: Additional graphical parameters.

Value

Invisibly, a ggplot object. Use plot_data() to retrieve its reusable plotting data and notes.

Plot types

"tif": overall design-weighted precision across theta.
"se" / "sem" / "csem": conditional SEM across theta.
"both": precision and conditional SEM together, useful for presentations.
"iif": facet-level contribution curves for one selected facet in a supported RSM, PCM, or GPCM fit.

Which type should I use?

Use "tif" for a quick overall read on precision.
Use "sem" or "csem" when standard-error language is easier to communicate than precision.
Use "both" when you want both views in one figure.
Use "iif" when you want to see which facet levels are shaping the total precision curve.

Interpreting output

The total curve peaks where the realized design is most precise.
Conditional SEM is derived as 1 / sqrt(precision); lower is better.
Facet-level curves show which facet levels contribute most to that realized precision at each theta.
For GPCM, those contributions include the squared discrimination scaling implied by the fitted slope_facet.
If the precision peak sits far from the bulk of person measures, the realized design may be poorly targeted.

Returned data when draw = FALSE

draw = FALSE returns a ggplot object without printing. Read its plotting data with plot_data(p, "plot"). For type = "tif", "se", or "both", those rows come from x$tif. For type = "iif", the returned rows come from x$iif filtered to the requested facet. The plot data also include plot_long, information_long, conditional_sem, summary, and settings so ggplot2, plotly, Quarto, and table workflows can reuse the information and conditional-SEM series without parsing the drawn figure.

Typical workflow

Compute information with compute_information().
Plot with plot(info) for the total precision curve.
Use plot(info, type = "iif", facet = "Rater") for facet-level contributions.
Use draw = FALSE when you want reusable plot data for custom graphics or reporting helpers.

Migration in 0.2.4

This renderer is internal. Use the corresponding plot() route in mfrmr_plot_migration; the former exported name is no longer available.