summary.mfrm_facets_run: Summarize a legacy-compatible workflow run

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

Summarize a legacy-compatible workflow run

Description

Summarize a legacy-compatible workflow run

Usage

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

Arguments

object	Output from run_mfrm_facets().
digits	Number of digits for numeric rounding in summaries.
top_n	Maximum rows shown in nested preview tables.
...	Passed through to nested summary methods.

Details

This method returns a compact cross-object summary that combines:

• model overview (object$fit$summary)

• resolved column mapping

• run settings (run_info)

• nested summaries of fit and diagnostics

Value

An object of class summary.mfrm_facets_run.

Interpreting output

• overview: convergence, information criteria, and scale size.

• mapping: sanity check for auto/explicit column mapping.

• fit / diagnostics: drill-down summaries for reporting decisions.

Typical workflow

1. Run run_mfrm_facets() to execute a one-shot pipeline.

2. Inspect with summary(out) for mapping and convergence checks.

3. Review nested objects (out$fit, out$diagnostics) as needed.

See Also

run_mfrm_facets(), summary.mfrm_fit(), mfrmr_workflow_methods, summary()

Examples

toy <- load_mfrmr_data("example_core")
toy_small <- toy[toy$Person %in% unique(toy$Person)[1:12], , drop = FALSE]
out <- run_mfrm_facets(
  data = toy_small,
  person = "Person",
  facets = c("Rater", "Criterion"),
  score = "Score",
  maxit = 10
)
s <- summary(out)
s$overview[, c("Model", "Method", "Converged")]
s$mapping

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