# Estimation and Diagnostics for Many-Facet Measurement Models

## Documentation for package ‘mfrmr’ version 0.2.0

- DESCRIPTION file.
- User guides, package vignettes and other documentation.
- Package NEWS.

## Help Pages

A B C D E F G I L M N P Q R S U V W

mfrmr-package | mfrmr: Many-Facet Ordered-Response Modeling in R

## -- A --

analyze_dff | Differential facet functioning analysis
analyze_dif | Differential facet functioning analysis
analyze_facet_equivalence | Analyze practical equivalence within a facet
analyze_hierarchical_structure | Analyze the hierarchical structure of a rating design
analyze_residual_pca | Run exploratory residual PCA summaries
anchor_review | Extract canonical review components
anchor_to_baseline | Fit new data anchored to a baseline calibration
apa_table | Build APA-style table output using base R structures
apply_empirical_bayes_shrinkage | Apply empirical-Bayes shrinkage to fitted non-person facet estimates
as.data.frame.mfrm_fit | Convert mfrm_fit to a tidy data.frame
assess_mfrm_recovery | Assess whether recovery-simulation results are ready to use
as_flextable | Generic for converting objects to a 'flextable'
as_flextable.apa_table | Convert an 'apa_table' to a 'flextable'
as_kable | Generic for converting objects to a 'knitr::kable'
as_kable.apa_table | Convert an 'apa_table' to a 'knitr::kable()' object

## -- B --

bias_count_table | Build a bias-cell count report
bias_interaction_report | Build a bias-interaction plot-data bundle (FACETS Table 13: ranked bias list)
bias_iteration_report | Build a bias-iteration report (FACETS Table 9: iteration / convergence trace)
bias_pairwise_report | Build a bias pairwise-contrast report (FACETS Table 14: pairwise contrasts)
build_apa_outputs | Build APA text outputs from model results
build_conquest_overlap_bundle | Build a scoped ConQuest-overlap bundle
build_equating_chain | Build a screened linking chain across ordered calibrations
build_fixed_reports | Build legacy-compatible fixed-width text reports
build_linking_review | Build a linking-review synthesis object
build_mfrm_manifest | Build a reproducibility manifest for an MFRM analysis
build_mfrm_replay_script | Build a package-native replay script for an MFRM analysis
build_mfrm_sim_spec | Build an explicit simulation specification for MFRM design studies
build_misfit_casebook | Build a case-level misfit review bundle
build_model_choice_review | Build a model-choice review across RSM, PCM, and bounded GPCM fits
build_summary_table_bundle | Build a manuscript-oriented table bundle from 'summary()' outputs
build_visual_summaries | Build warning and narrative summaries for visual outputs
build_weighting_review | Build a weighting-policy review between Rasch-family and bounded GPCM fits

## -- C --

category_curves_report | Build a category curve export bundle (preferred alias)
category_structure_report | Build a category structure report (preferred alias)
compare_mfrm | Compare two or more fitted MFRM models
compatibility_alias_table | List retained compatibility aliases and preferred names
compute_facet_design_effect | Compute Kish design effects for each facet
compute_facet_icc | Compute intra-class correlations for each facet
compute_information | Compute design-weighted precision curves for ordered many-facet fits
compute_person_fit_indices | Person fit indices: lz and Snijders-corrected lz*

## -- D --

data_quality_report | Build a data quality summary report (preferred alias)
describe_mfrm_data | Summarize MFRM input data (TAM-style descriptive snapshot)
detect_anchor_drift | Detect anchor drift across multiple calibrations
detect_facet_nesting | Detect nesting structure between facets
diagnose_mfrm | Compute diagnostics for an 'mfrm_fit' object
dif_interaction_table | Compute interaction table between a facet and a grouping variable
dif_report | Generate a differential-functioning interpretation report
displacement_table | Compute displacement diagnostics for facet levels

## -- E --

ej2021_combined | Simulated MFRM datasets based on Eckes and Jin (2021)
ej2021_combined_itercal | Simulated MFRM datasets based on Eckes and Jin (2021)
ej2021_data | Simulated MFRM datasets based on Eckes and Jin (2021)
ej2021_study1 | Simulated MFRM datasets based on Eckes and Jin (2021)
ej2021_study1_itercal | Simulated MFRM datasets based on Eckes and Jin (2021)
ej2021_study2 | Simulated MFRM datasets based on Eckes and Jin (2021)
ej2021_study2_itercal | Simulated MFRM datasets based on Eckes and Jin (2021)
estimate_all_bias | Estimate bias across multiple facet pairs
estimate_bias | Estimate bias and interaction screening terms
estimation_iteration_report | Build an estimation-iteration report (preferred alias)
evaluate_mfrm_design | Evaluate MFRM design conditions by repeated simulation
evaluate_mfrm_diagnostic_screening | Evaluate legacy and strict marginal diagnostic screening under controlled misfit scenarios
evaluate_mfrm_recovery | Evaluate parameter recovery by repeated simulation and refitting
evaluate_mfrm_signal_detection | Evaluate DIF power and bias-screening behavior under known simulated signals
export_mfrm | Export MFRM results to CSV files
export_mfrm_bundle | Export an analysis bundle for sharing or archiving
export_summary_appendix | Export manuscript appendix tables from validated summary surfaces
extract_mfrm_sim_spec | Derive a simulation specification from a fitted MFRM object

## -- F --

facets_chisq_table | Build facet variability diagnostics with fixed/random reference tests
facets_feature_coverage | FACETS Feature Coverage Matrix
facets_fit_df_guide | Guide FACETS-style fit df and ZSTD standardization
facets_fit_review | Review fit standardization against FACETS-style ZSTD conventions
facets_output_contract_review | Build a FACETS output-contract review
facets_output_file_bundle | Build a legacy-compatible output-file bundle (GRAPH= / SCORE=)
facets_positioning_guide | FACETS Positioning Guide
facet_quality_dashboard | Facet-quality dashboard for facet-level screening
facet_small_sample_review | Review per-facet-level sample adequacy
facet_statistics_report | Build a facet statistics report (preferred alias)
fair_average_table | Build an adjusted-score reference table bundle
fit_measures_table | Build a FACETS-style fit-measures review table
fit_mfrm | Fit many-facet ordered-response models with a flexible number of facets

## -- G --

gpcm_capability_matrix | Bounded GPCM Support Matrix

## -- I --

import_erm_fit | Import an 'eRm' fit to an mfrmr-compatible bundle
import_facets_fit_table | Read a FACETS fit table for fit review
import_mirt_fit | Import an 'mirt' fit to an mfrmr-compatible bundle
import_tam_fit | Import a 'TAM' fit to an mfrmr-compatible bundle
interaction_effect_table | Extract model-estimated facet interaction effects
interrater_agreement_table | Build an inter-rater agreement report

## -- L --

list_mfrmr_data | List packaged simulation datasets
load_mfrmr_data | Load a packaged simulation dataset

## -- M --

make_anchor_table | Build an anchor table from fitted estimates
measurable_summary_table | Build a measurable-data summary
mfrmr | mfrmr: Many-Facet Ordered-Response Modeling in R
mfrmRFacets | Run a legacy-compatible estimation workflow wrapper
mfrmr_compatibility_layer | mfrmr Compatibility Layer Map
mfrmr_example_bias | Purpose-built example datasets for package help pages
mfrmr_example_core | Purpose-built example datasets for package help pages
mfrmr_example_data | Purpose-built example datasets for package help pages
mfrmr_linking_and_dff | mfrmr Linking and DFF Guide
mfrmr_output_guide | Choose an mfrmr output helper by user goal
mfrmr_reporting_and_apa | mfrmr Reporting and APA Guide
mfrmr_reports_and_tables | mfrmr Reports and Tables Map
mfrmr_visual_diagnostics | mfrmr Visual Diagnostics Map
mfrmr_workflow_methods | mfrmr Workflow and Method Map
mfrm_d_study | Project G-theory coefficients under alternative D-study designs
mfrm_generalizability | Generalizability-theory variance decomposition for an MFRM design
mfrm_misfit_thresholds | MnSq misfit threshold pair used across mfrmr screening helpers
mfrm_network_analysis | Analyze the MFRM design network
mfrm_threshold_profiles | List literature-based warning threshold profiles

## -- N --

normalize_conquest_overlap_files | Normalize extracted ConQuest overlap files to the 'mfrmr' review contract
normalize_conquest_overlap_tables | Normalize extracted ConQuest overlap tables to the 'mfrmr' review contract

## -- P --

plot.apa_table | Plot an APA/FACETS table object using base R
plot.mfrm_anchor_review | Plot an anchor-review object
plot.mfrm_bundle | Plot report/table bundles with base R defaults
plot.mfrm_data_description | Plot a data-description object
plot.mfrm_design_evaluation | Plot a design-simulation study
plot.mfrm_equating_chain | Build a screened linking chain across ordered calibrations
plot.mfrm_facets_run | Plot outputs from a legacy-compatible workflow run
plot.mfrm_facet_nesting | Plot the pairwise nesting index matrix
plot.mfrm_facet_sample_review | Plot a facet sample-size review
plot.mfrm_fit | Plot fitted MFRM results with base R
plot.mfrm_future_branch_active_branch | Plot a future arbitrary-facet planning active branch
plot.mfrm_recovery_assessment | Assess whether recovery-simulation results are ready to use
plot.mfrm_recovery_simulation | Plot parameter-recovery simulation results
plot.mfrm_signal_detection | Plot DIF/bias screening simulation results
plot.mfrm_summary_table_bundle | Plot a summary-table bundle for manuscript QC
plot_anchor_drift | Plot anchor drift or a screened linking chain
plot_apa_figure_one | Manuscript-ready four-panel composite (Wright + severity + threshold + summary)
plot_bias_interaction | Plot bias interaction diagnostics (preferred alias)
plot_bubble | Bubble chart of measure estimates and fit statistics
plot_data | Extract reusable data from an mfrmr plot object
plot_data_components | List reusable components in mfrmr plot data
plot_dif_heatmap | Plot a differential-functioning heatmap
plot_dif_summary | Summary plot of differential functioning effect sizes
plot_displacement | Plot displacement diagnostics using base R
plot_facets_chisq | Plot facet variability diagnostics using base R
plot_facet_equivalence | Plot facet-equivalence results
plot_facet_quality_dashboard | Plot a facet-quality dashboard
plot_fair_average | Plot fair-average diagnostics using base R
plot_guttman_scalogram | Guttman-style scalogram of person x item observed responses
plot_information | Plot design-weighted precision curves
plot_interrater_agreement | Plot inter-rater agreement diagnostics using base R
plot_local_dependence_heatmap | Pairwise standardized-residual heatmap for local-dependence review
plot_marginal_fit | Plot strict marginal-fit follow-up cells using base R
plot_marginal_pairwise | Plot strict pairwise local-dependence follow-up using base R
plot_person_fit | Plot per-person fit
plot_qc_dashboard | Plot a base-R QC dashboard
plot_qc_pipeline | Plot QC pipeline results
plot_rater_agreement_heatmap | Pairwise rater-agreement heatmap
plot_rater_severity_profile | Plot per-rater severity ranking with confidence interval whiskers
plot_rater_trajectory | Rater-severity trajectory across an ordered wave / occasion variable
plot_reliability_snapshot | Facet reliability and separation snapshot bar plot
plot_residual_matrix | Person x facet-level standardized-residual matrix
plot_residual_pca | Visualize residual PCA results
plot_residual_qq | Normal quantile-quantile plot of person standardized residuals
plot_shrinkage_funnel | Empirical-Bayes shrinkage funnel / caterpillar
plot_threshold_ladder | Plot RSM/PCM threshold ladders with disorder highlighting
plot_unexpected | Plot unexpected responses using base R
plot_wright_unified | Plot a unified Wright map with all facets on a shared logit scale
precision_review | Extract canonical review components
precision_review_report | Build a precision review report
predict_mfrm_population | Forecast population-level MFRM operating characteristics for one future design
predict_mfrm_units | Score future or partially observed units under the fitted scoring basis
print.mfrm_anchored_fit | Fit new data anchored to a baseline calibration
print.mfrm_anchor_drift | Detect anchor drift across multiple calibrations
print.mfrm_apa_text | Print APA narrative text with preserved line breaks
print.mfrm_equating_chain | Build a screened linking chain across ordered calibrations
print.summary.mfrm_anchored_fit | Fit new data anchored to a baseline calibration
print.summary.mfrm_anchor_drift | Detect anchor drift across multiple calibrations
print.summary.mfrm_equating_chain | Build a screened linking chain across ordered calibrations

## -- Q --

q3_statistic | Yen-style Q3 local-dependence statistic between facet levels

## -- R --

rater_halo_network_analysis | Analyze rater-by-criterion halo-effect networks
rater_network_analysis | Analyze rater agreement, disagreement, and severity-direction networks
rating_scale_table | Build a rating-scale diagnostics report
read_facets_fit_table | Read a FACETS fit table for fit review
recode_missing_codes | Recode common missing-value sentinels to 'NA'
recommend_mfrm_design | Recommend a design condition from simulation results
reference_case_benchmark | Benchmark packaged reference cases
reference_case_review | Build a package-native reference review for report completeness
reporting_checklist | Build an auto-filled MFRM reporting checklist
review_accessors | Extract canonical review components
review_conquest_overlap | Review an exact-overlap ConQuest comparison against an 'mfrmr' overlap bundle
review_mfrm_anchors | Review and normalize anchor/group-anchor tables
run_mfrm_facets | Run a legacy-compatible estimation workflow wrapper
run_qc_pipeline | Run automated quality control pipeline

## -- S --

sample_mfrm_plausible_values | Sample approximate plausible values under fitted posterior scoring
shrinkage_report | Extract the shrinkage report from a fitted mfrm_fit
simulate_mfrm_data | Simulate long-format ordered many-facet data for design studies
specifications_report | Build a specification summary report (preferred alias)
subset_connectivity_report | Build a subset connectivity report (preferred alias)
summary.apa_table | Summarize an APA/FACETS table object
summary.mfrm_anchored_fit | Fit new data anchored to a baseline calibration
summary.mfrm_anchor_drift | Detect anchor drift across multiple calibrations
summary.mfrm_anchor_review | Summarize an anchor-review object
summary.mfrm_apa_outputs | Summarize APA report-output bundles
summary.mfrm_bias | Summarize an 'mfrm_bias' object in a user-friendly format
summary.mfrm_bundle | Summarize report/table bundles in a user-friendly format
summary.mfrm_data_description | Summarize a data-description object
summary.mfrm_design_evaluation | Summarize a design-simulation study
summary.mfrm_diagnostics | Summarize an 'mfrm_diagnostics' object in a user-friendly format
summary.mfrm_equating_chain | Build a screened linking chain across ordered calibrations
summary.mfrm_facets_run | Summarize a legacy-compatible workflow run
summary.mfrm_facet_dashboard | Summarize a facet-quality dashboard
summary.mfrm_fit | Summarize an 'mfrm_fit' object in a user-friendly format
summary.mfrm_future_branch_active_branch | Summarize a future arbitrary-facet planning active branch
summary.mfrm_linking_review | Summarize a linking-review object
summary.mfrm_misfit_casebook | Summarize a misfit-casebook object
summary.mfrm_model_choice_review | Summarize a model-choice review
summary.mfrm_person_fit_indices | Summarize person-fit indices
summary.mfrm_plausible_values | Summarize approximate plausible values from posterior scoring
summary.mfrm_population_prediction | Summarize a population-level design forecast
summary.mfrm_reporting_checklist | Summarize a reporting-checklist bundle for manuscript work
summary.mfrm_signal_detection | Summarize a DIF/bias screening simulation
summary.mfrm_summary_table_bundle | Summarize a summary-table bundle for manuscript QC
summary.mfrm_threshold_profiles | Summarize threshold-profile presets for visual warning logic
summary.mfrm_unit_prediction | Summarize posterior unit scoring output
summary.mfrm_weighting_review | Summarize a weighting-review object

## -- U --

unexpected_after_bias_table | Build an unexpected-after-adjustment screening report
unexpected_response_table | Build an unexpected-response screening report

## -- V --

visual_reporting_template | Figure-reporting template for visual diagnostics

## -- W --

write_mfrm_residual_file | Write a standalone residual file
write_mfrm_subset_file | Write standalone subset-connectivity files