plot_information: Plot design-weighted precision curves

In mfrmr: Estimation and Diagnostics for Many-Facet Measurement Models

Plot design-weighted precision curves

Description

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", "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" for the approximate standard error implied by that curve, or "both" for precision with approximate SE on a secondary axis.
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 plot data invisibly.
...	Additional graphical parameters.

Value

Invisibly, the plot data (tibble).

Plot types

• "tif": overall design-weighted precision across theta.

• "se": approximate standard error across theta.

• "both": precision and approximate SE together, useful for presentations.

• "iif": facet-level contribution curves for one selected facet in an RSM fit.

Which type should I use?

• Use "tif" for a quick overall read on precision.

• Use "se" 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.

• SE 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.

• If the precision peak sits far from the bulk of person measures, the realized design may be poorly targeted.

Returned data when draw = FALSE

For type = "tif", "se", or "both", the returned data come from x$tif. For type = "iif", the returned data are the rows of x$iif filtered to the requested facet.

Typical workflow

1. Compute information with compute_information().

2. Plot with plot_information(info) for the total precision curve.

3. Use plot_information(info, type = "iif", facet = "Rater") for facet-level contributions.

4. Use draw = FALSE when you want the plotting data for custom graphics.

See Also

compute_information(), fit_mfrm()

Examples

toy <- load_mfrmr_data("example_core")
fit <- fit_mfrm(toy, "Person", c("Rater", "Criterion"), "Score",
                 method = "JML", model = "RSM", maxit = 25)
info <- compute_information(fit)
tif_data <- plot_information(info, type = "tif", draw = FALSE)
head(tif_data)
iif_data <- plot_information(info, type = "iif", facet = "Rater", draw = FALSE)
head(iif_data)

mfrmr documentation built on March 31, 2026, 1:06 a.m.