Skip to contents

Summarize an anchor-audit object

Usage

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

Arguments

object

Output from audit_mfrm_anchors().

digits

Number of digits for numeric rounding.

top_n

Maximum rows shown in issue previews.

...

Reserved for generic compatibility.

Value

An object of class summary.mfrm_anchor_audit.

Details

This summary provides a compact pre-estimation audit of anchor and group-anchor specifications.

Interpreting output

Recommended order:

  • issue_counts: primary triage table (non-zero issues first).

  • facet_summary: anchored/grouped/free-level balance by facet.

  • level_observation_summary and category_counts: sparse-cell diagnostics.

  • recommendations: concrete remediation suggestions.

If issue_counts is non-empty, treat anchor constraints as provisional and resolve issues before final estimation.

Typical workflow

  1. Run audit_mfrm_anchors() with intended anchors/group anchors.

  2. Review summary(aud) and recommendations.

  3. Revise anchor tables, then call fit_mfrm().

Examples

toy <- load_mfrmr_data("example_core")
aud <- audit_mfrm_anchors(toy, "Person", c("Rater", "Criterion"), "Score")
summary(aud)
#> mfrm Anchor Audit Summary
#> 
#> Facet summary
#>      Facet Levels AnchoredLevels GroupedLevels GroupCount ConstrainedLevels
#>     Person     48              0             0          0                 0
#>      Rater      4              0             0          0                 0
#>  Criterion      4              0             0          0                 0
#>  OverlapLevels FreeLevels Noncenter DummyFacet
#>              0         48      TRUE      FALSE
#>              0          4     FALSE      FALSE
#>              0          4     FALSE      FALSE
#> 
#> Level observation summary
#>      Facet Levels MinObsPerLevel MedianObsPerLevel RecommendedMinObs PassMinObs
#>  Criterion      4            192               192                30       TRUE
#>     Person     48             16                16                30      FALSE
#>      Rater      4            192               192                30       TRUE
#> 
#> Category counts
#>  Category RawN WeightedN RecommendedMinObs PassMinObs
#>         1  139       139                10       TRUE
#>         2  241       241                10       TRUE
#>         3  252       252                10       TRUE
#>         4  136       136                10       TRUE
#> 
#> Recommendations
#>  - Linacre guideline: about 30 observations per element are desirable. Low-observation facets: Person.
#>  - For linked analyses, keep Umean/Uscale from the source calibration so reporting origin and scaling stay consistent.
#>  - Current noncenter facet is 'Person'. Other facets are centered unless constrained by anchors/group anchors.
#> 
#> Notes
#>  - No anchor-table issue rows were detected.