Skip to contents

Print APA narrative text with preserved line breaks

Usage

# S3 method for class 'mfrm_apa_text'
print(x, ...)

Arguments

x

Character text object from build_apa_outputs()$report_text.

...

Reserved for generic compatibility.

Value

The input object (invisibly).

Details

Prints APA narrative text with preserved paragraph breaks using cat(). This is preferred over bare print() when you want readable multi-line report output in the console.

Interpreting output

The printed text is the same content stored in build_apa_outputs(...)$report_text, but with explicit paragraph breaks.

Typical workflow

  1. Generate apa <- build_apa_outputs(...).

  2. Print readable narrative with apa$report_text.

  3. Use summary(apa) to check completeness before manuscript use.

Examples

toy <- load_mfrmr_data("example_core")
fit <- fit_mfrm(toy, "Person", c("Rater", "Criterion"), "Score", method = "JML", maxit = 25)
diag <- diagnose_mfrm(fit, residual_pca = "both")
apa <- build_apa_outputs(fit, diag)
apa$report_text
#> Method.
#> 
#> Design and data.
#> A many-facet Rasch model (MFRM) was fit to 768 observations from 48 persons scored on a
#> 4-category scale (1-4). The design included facets for Rater (n = 4), Criterion (n = 4).
#> 
#> Estimation settings.
#> The RSM specification was estimated using JMLE in the native R MFRM package. Precision
#> summaries were exploratory in this run. Recommended use for this precision profile: Use for
#> screening and calibration triage; confirm formal SE, CI, and reliability with an MML fit..
#> Optimization converged after 67 function evaluations (LogLik = -820.949, AIC = 1755.899,
#> BIC = 2020.595). Constraint settings: noncenter facet = Person; anchored levels = 0
#> (facets: none); group anchors = 0 (facets: none); dummy facets = none.
#> 
#> Results.
#> 
#> Scale functioning.
#> Category usage was adequate (unused categories = 0, low-count categories = 0), and
#> thresholds were ordered. Step/threshold summary: 3 step(s); estimate range = -1.33 to 1.39
#> logits; no disordered steps.
#> 
#> Facet measures.
#> Person measures ranged from -2.18 to 2.69 logits (M = 0.00, SD = 1.10). Rater measures
#> ranged from -0.33 to 0.33 logits (M = 0.00, SD = 0.31). Criterion measures ranged from
#> -0.41 to 0.25 logits (M = 0.00, SD = 0.29).
#> 
#> Fit and precision.
#> Overall fit was acceptable (infit MnSq = 0.99, outfit MnSq = 1.02). 1 of 56 elements
#> exceeded the 0.5-1.5 fit range. Largest misfit signals: Person:P023 (|metric| = 3.06);
#> Person:P018 (|metric| = 1.51); Criterion:Organization (|metric| = 1.42). Criterion
#> exploratory reliability summary = 0.88 (separation = 2.77). Person exploratory reliability
#> summary = 0.90 (separation = 3.01). Rater exploratory reliability summary = 0.90
#> (separation = 3.05). For Rater, exact agreement = 0.36, expected exact agreement = 0.37,
#> adjacent agreement = 0.83.
#> 
#> Residual structure.
#> Exploratory residual PCA (overall standardized residual matrix) showed PC1 eigenvalue =
#> 2.11 (13.2% variance), with PC2 eigenvalue = 1.83. Facet-specific exploratory residual PCA
#> showed the largest first-component signal in Rater (eigenvalue = 1.72, 43.0% variance).
#> Heuristic reference bands: EV >= 1.4 (critical minimum), >= 1.5 (caution), >= 2.0 (common),
#> >= 3.0 (strong); variance >= 5% (minor), >= 10% (caution), >= 20% (strong).
#> 
#> Reporting cautions.
#> Precision note: this run relies on exploratory precision summaries, so confidence intervals
#> and reliability summaries should not be treated as formal inferential quantities.