Standardized Report for Correlation Synthesis and Latent Factors

Builds a standardized report object with pooled correlations, uncertainty, heterogeneity summaries, latent-factor solution tables, publication-ready tables, plot-ready matrices, reproducibility metadata, and limitations. Use plot(report, type = ...) with "pooled_r", "heterogeneity", "residuals", "calibration", "loadings", "path", "influence", "influence_heatmap", or "invariance".

synthesis_factor_report(
  mars_object,
  factor_method = c("none", "efa", "cfa"),
  n_factors = 1L,
  cfa_model = NULL,
  group_var = NULL,
  loading_threshold = 0.3,
  synthesis_method = c("model", "average", "weighted"),
  synthesis_transform = c("none", "fisher_z"),
  missing_corr = c("available", "pairwise", "em"),
  attenuation = c("none", "correct"),
  reliability = NULL,
  reliability_missing = c("error", "skip", "impute_mean", "assume_1"),
  missing_sensitivity = FALSE,
  attenuation_sensitivity = FALSE,
  reliability_scenarios = NULL,
  pd_adjust = c("none", "eigen_clip", "nearpd"),
  pd_tol = 1e-08,
  include_publication_bias = TRUE,
  ...
)

Arguments

mars_object: A fitted object returned by mars.
factor_method: One of "none", "efa", or "cfa".
n_factors: Number of factors when factor_method = "efa".
cfa_model: Lavaan-style latent model syntax when factor_method = "cfa".
group_var: Optional grouping/moderator variable name in mars_object$data used for multi-group configural vs metric-style CFA checks.
loading_threshold: Absolute-value threshold used to flag salient loadings.
synthesis_method: Correlation synthesis method: "model", "average", or "weighted".
synthesis_transform: Optional pooling transform for "average"/"weighted": "none" or "fisher_z".
missing_corr: Missing-correlation handling for synthesized matrices: "available", "pairwise", or "em".
attenuation: Attenuation-correction mode for synthesized correlations: "none" or "correct".
reliability: Reliability input used when attenuation = "correct".
reliability_missing: Strategy for missing reliability values: "error", "skip", "impute_mean", or "assume_1".
missing_sensitivity: Logical; if TRUE, computes pooled-correlation sensitivity across missing-correlation handling methods.
attenuation_sensitivity: Logical; if TRUE, computes pooled-correlation sensitivity across attenuation settings.
reliability_scenarios: Optional named list of reliability inputs used when attenuation_sensitivity = TRUE. Each element should be a valid reliability object (named vector or data frame).
pd_adjust: Positive-definite repair for synthesized correlations: "none", "eigen_clip", or "nearpd".
pd_tol: Minimum eigenvalue tolerance used by pd_adjust = "eigen_clip".
include_publication_bias: Logical; if TRUE, attempts an Egger-type small-study-effects check.
...: Additional arguments passed to efa_from_synthesis or cfa_from_synthesis.

Value

An object of class synthesis_report.