mfrmr_reports_and_tables: mfrmr Reports and Tables Map

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

mfrmr Reports and Tables Map

Description

Quick guide to choosing the right report or table helper in mfrmr. Use this page when you know the reporting question but have not yet decided which bundle, table, or reporting helper to call.

Start with the question

• "How should I document the model setup and run settings?" Use specifications_report().

• "Was data filtered, dropped, or mapped in unexpected ways?" Use data_quality_report() and describe_mfrm_data().

• "Did estimation converge cleanly and how formal is the precision layer?" Use estimation_iteration_report() and precision_audit_report().

• "Which facets are measurable, variable, or weakly separated?" Use facet_statistics_report(), measurable_summary_table(), and facets_chisq_table().

• "Are score categories functioning in a usable sequence?" Use rating_scale_table(), category_structure_report(), and category_curves_report().

• "Is the design linked well enough across subsets, forms, or waves?" Use subset_connectivity_report() and plot_anchor_drift().

• "What should go into the manuscript text and tables?" Use reporting_checklist() and build_apa_outputs().

Recommended report route

1. Start with specifications_report() and data_quality_report() to document the run and confirm usable data.

2. Continue with estimation_iteration_report() and precision_audit_report() to judge convergence and inferential strength.

3. Use facet_statistics_report() and subset_connectivity_report() to describe spread, linkage, and measurability.

4. Add rating_scale_table(), category_structure_report(), and category_curves_report() to document scale functioning.

5. Finish with reporting_checklist() and build_apa_outputs() for manuscript-oriented output.

Which output answers which question

specifications_report()

Documents model type, estimation method, anchors, and core run settings. Best for method sections and audit trails.

data_quality_report()

Summarizes retained and dropped rows, missingness, and unknown elements. Best for data cleaning narratives.

estimation_iteration_report()

Shows replayed convergence trajectories. Best for diagnosing slow or unstable estimation.

precision_audit_report()

Summarizes whether SE, CI, and reliability indices are model-based, hybrid, or exploratory. Best for deciding how strongly to phrase inferential claims.

facet_statistics_report()

Bundles facet summaries, precision summaries, and variability tests. Best for facet-level reporting.

subset_connectivity_report()

Summarizes disconnected subsets and coverage bottlenecks. Best for linking and anchor strategy review.

rating_scale_table()

Gives category counts, average measures, and threshold diagnostics. Best for first-pass category evaluation.

category_structure_report()

Adds transition points and compact category warnings. Best for category-order interpretation.

category_curves_report()

Returns category-probability curve coordinates and summaries. Best for downstream graphics and report drafts.

reporting_checklist()

Turns analysis status into an action list with priorities and next steps. Best for closing reporting gaps.

build_apa_outputs()

Creates manuscript-draft text, notes, captions, and section maps from a shared reporting contract.

Practical interpretation rules

• Use bundle summaries first, then drill down into component tables.

• Treat precision_audit_report() as the gatekeeper for formal inference.

• Treat category and bias outputs as complementary layers rather than substitutes for overall fit review.

• Use reporting_checklist() before build_apa_outputs() when a report still needs missing diagnostics or clearer caveats.

Typical workflow

• Run documentation: fit_mfrm() -> specifications_report() -> data_quality_report().

• Precision and facet review: diagnose_mfrm() -> precision_audit_report() -> facet_statistics_report().

• Scale review: rating_scale_table() -> category_structure_report() -> category_curves_report().

• Manuscript handoff: reporting_checklist() -> build_apa_outputs().

Companion guides

• For visual follow-up, see mfrmr_visual_diagnostics.

• For one-shot analysis routes, see mfrmr_workflow_methods.

• For manuscript assembly, see mfrmr_reporting_and_apa.

• For linking and DFF review, see mfrmr_linking_and_dff.

• For legacy-compatible wrappers and exports, see mfrmr_compatibility_layer.

Examples

toy <- load_mfrmr_data("example_core")
toy_small <- toy[toy$Person %in% unique(toy$Person)[1:12], , drop = FALSE]
fit <- fit_mfrm(
  toy_small,
  person = "Person",
  facets = c("Rater", "Criterion"),
  score = "Score",
  method = "JML",
  maxit = 10
)
diag <- diagnose_mfrm(fit, residual_pca = "none")

spec <- specifications_report(fit)
summary(spec)

prec <- precision_audit_report(fit, diagnostics = diag)
summary(prec)

checklist <- reporting_checklist(fit, diagnostics = diag)
names(checklist)

apa <- build_apa_outputs(fit, diagnostics = diag)
names(apa$section_map)

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