Skip to contents

Build a linking-review synthesis object

Source: R/api-advanced.R
build_linking_review.Rd

Build a linking-review synthesis object

Usage

build_linking_review(
  anchor_review = NULL,
  drift = NULL,
  chain = NULL,
  top_n = 10
)

# S3 method for class 'mfrm_linking_review'
summary(object, digits = 3, top_n = 10, ...)

Arguments

anchor_review

Optional output from review_mfrm_anchors().

drift

Optional output from detect_anchor_drift().

chain

Optional output from build_equating_chain().

top_n

For build_linking_review(): Maximum number of linking-risk rows to highlight in summary outputs. The full object keeps the full risk tables.

For summary(): Number of top linking-risk rows to keep in the compact summary.

object

Output from build_linking_review().

digits

Number of digits for printed numeric values.

...

Reserved for generic compatibility.

Value

An object of class mfrm_linking_review.

For summary(): An object of class summary.mfrm_linking_review.

Details

build_linking_review() does not recompute anchor, drift, or chain statistics. It is a synthesis layer that organizes package-native evidence into one operational review surface with:

  • a front-door status block,

  • ranked linking risks,

  • explicit next actions,

  • plot routing metadata,

  • a reporting/export handoff map.

The helper keeps the current conservative interpretation policy: anchor drift and screened links are operational review tools, not automatic proofs of scale equivalence or score comparability. It also does not verify source-fit readiness, cross-wave element identity, invariance, or the external assumptions behind group anchors; these must be established before promoting the synthesized review.

summary() method: Summarize a linking-review object

Use existing package-native outputs in this order:

  1. review_mfrm_anchors() for pre-fit anchor adequacy.

  2. detect_anchor_drift() for direct wave-to-reference drift screening.

  3. build_equating_chain() for adjacent screened-link review across waves.

Interpreting output

  • overview: which evidence sources were supplied and the current review status.

  • top_linking_risks: primary operational triage table.

  • group_view_index: stable wave/link/facet/source-family grouping routes.

  • plot_map: which plotting function to use for each result.

  • reporting_map: what is covered here versus which manuscript-oriented helper should be used separately.

GPCM boundary

This helper summarizes the documented RSM / PCM linking workflow. When supplied drift/chain sources resolve to GPCM, it retains an explicitly exploratory review and marks that scope as supported_with_caveat. This does not establish score interchangeability, invariance or a common scale across administrations.

See also

review_mfrm_anchors(), detect_anchor_drift(), build_equating_chain(), plot(x), mfrmr_linking_and_dff

build_linking_review()

Examples

# Long-running workflow; run explicitly when needed.
# example("build_linking_review", run.dontrun = TRUE)
if (FALSE) { # \dontrun{
# Deliberately linked teaching waves: common labels below represent the
# same rater and criterion identities by construction.
toy <- load_mfrmr_data("example_core")
people <- unique(toy$Person)
# Two balanced 24-Person waves retain every Rater and Criterion.
d1 <- toy[toy$Person %in% people[1:24], , drop = FALSE]
d2 <- toy[toy$Person %in% people[25:48], , drop = FALSE]
fit1 <- fit_mfrm(d1, "Person", c("Rater", "Criterion"), "Score",
                 method = "MML", quad_points = 7, maxit = 30)
fit2 <- fit_mfrm(d2, "Person", c("Rater", "Criterion"), "Score",
                 method = "MML", quad_points = 7, maxit = 30)
anchor_review_obj <- review_mfrm_anchors(d1, "Person", c("Rater", "Criterion"), "Score")
drift <- detect_anchor_drift(list(Wave1 = fit1, Wave2 = fit2))
chain <- build_equating_chain(list(Wave1 = fit1, Wave2 = fit2))
review <- build_linking_review(anchor_review = anchor_review_obj, drift = drift, chain = chain)
summary(review)
review$top_linking_risks
review$group_view_index
} # }