build_model_choice_review: Build a model-choice review across RSM, PCM, and bounded GPCM...

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

Build a model-choice review across RSM, PCM, and bounded GPCM fits

Description

Build a model-choice review across RSM, PCM, and bounded GPCM fits

Usage

build_model_choice_review(
  ...,
  labels = NULL,
  run_weighting_review = NULL,
  theta_range = c(-6, 6),
  theta_points = 61L,
  top_n = 10L,
  warn_constraints = TRUE
)

Arguments

...	Two or more fitted mfrm_fit objects from fit_mfrm().
labels	Optional labels for the supplied fits. If omitted, names from ... are used when available; otherwise labels are generated from model/method combinations.
run_weighting_review	Logical. If TRUE and the supplied fits include at least one RSM/PCM reference plus one bounded GPCM fit, also run build_weighting_review() for the first such pair.
theta_range, theta_points, top_n	Passed to build_weighting_review() when run_weighting_review = TRUE.
warn_constraints	Passed to compare_mfrm().

Details

build_model_choice_review() is a user-facing synthesis helper. It does not estimate new models. It bundles:

• compare_mfrm() for AIC/BIC/log-likelihood comparison;

• model-role guidance for RSM, PCM, and bounded GPCM;

• downstream-route availability for APA output, score-side export, linking, recovery, fair averages, bias screening, and summary-appendix handoff;

• report wording templates that avoid treating better bounded-GPCM fit as an automatic operational-scoring decision;

• gpcm_capability_matrix() when bounded GPCM is present;

• optionally, build_weighting_review() for the first Rasch-family reference versus bounded-GPCM pair.

The word "bounded" is intentional: the package implements a bounded GPCM route, not every possible generalized partial-credit many-facet extension. The current route uses positive slopes, requires slope_facet == step_facet, identifies slopes on the log scale with geometric mean 1, and keeps several downstream score-side/reporting helpers outside the validated boundary.

Value

An object of class mfrm_model_choice_review.

See Also

compare_mfrm(), build_weighting_review(), gpcm_capability_matrix(), compute_information()

Examples

toy <- load_mfrmr_data("example_core")
fit_rsm <- fit_mfrm(toy, "Person", c("Rater", "Criterion"), "Score",
                    method = "MML", model = "RSM", quad_points = 7)
fit_pcm <- fit_mfrm(toy, "Person", c("Rater", "Criterion"), "Score",
                    method = "MML", model = "PCM", step_facet = "Criterion",
                    quad_points = 7)
review <- build_model_choice_review(RSM = fit_rsm, PCM = fit_pcm)
summary(review)

mfrmr documentation built on June 13, 2026, 1:07 a.m.