facets_feature_coverage: FACETS Feature Coverage Matrix

View source: R/help_facets_coverage.R

facets_feature_coverageR Documentation

FACETS Feature Coverage Matrix

Description

facets_feature_coverage() summarizes how the current mfrmr release maps the main FACETS output-table, output-file, and graph-menu surface to package functions.

Use this helper before migration work when you need a public, user-facing answer to three questions:

  • which FACETS outputs have a close mfrmr route,

  • which outputs are only partially covered by structured R objects,

  • which FACETS-specific outputs are not implemented or intentionally outside the current package scope.

Usage

facets_feature_coverage(
  status = c("all", "implemented", "partial", "not_implemented", "not_targeted")
)

Arguments

status

Which rows to return. "all" returns the full matrix. Other values filter by the Status column.

Details

The matrix is based on the FACETS 64-bit output index, which lists output Tables 1–14, DIF/bias plots, R/Web plots, output files, and graph-menu curves. mfrmr intentionally prioritizes structured R tables and reusable plot data over exact FACETS line-printer output.

Status meanings:

  • implemented: a package-native route covers the substantive output.

  • partial: the concept is covered, but not the full FACETS formatting, option surface, file type, or external integration.

  • not_implemented: a FACETS feature has no direct package-native route in the current release.

  • not_targeted: the feature is tied to FACETS UI, Web/Excel handoff, or another external program format and is not a release goal.

Value

A data.frame with columns:

  • FACETSArea

  • FACETSFeature

  • FACETSReference

  • mfrmrRoute

  • Status

  • Scope

  • GapOrBoundary

  • Priority

References

Linacre, J. M. (2026). A user's guide to FACETS, version 4.5.0. Output tables - files - plots - graphs: https://www.winsteps.com/facetman64/outputtableindex.htm.

See Also

facets_positioning_guide(), mfrmr_output_guide(), facets_fit_df_guide(), read_facets_fit_table(), facets_fit_review(), gpcm_capability_matrix()

Examples

facets_feature_coverage()
facets_feature_coverage("partial")
facets_feature_coverage("not_implemented")

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