% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/api-reports.R
\name{facet_statistics_report}
\alias{facet_statistics_report}
\title{Build a facet statistics report (preferred alias)}
\usage{
facet_statistics_report(
  fit,
  diagnostics = NULL,
  metrics = c("Estimate", "Infit", "Outfit", "SE"),
  ruler_width = 41,
  distribution_basis = c("both", "sample", "population"),
  se_mode = c("both", "model", "fit_adjusted")
)
}
\arguments{
\item{fit}{Output from \code{\link[=fit_mfrm]{fit_mfrm()}}.}

\item{diagnostics}{Optional output from \code{\link[=diagnose_mfrm]{diagnose_mfrm()}}.}

\item{metrics}{Numeric columns in \code{diagnostics$measures} to summarize.}

\item{ruler_width}{Width of the fixed-width ruler used for \code{M/S/Q/X} marks.}

\item{distribution_basis}{Which distribution basis to keep in the appended
precision summary: \code{"both"} (default), \code{"sample"}, or \code{"population"}.}

\item{se_mode}{Which standard-error mode to keep in the appended precision
summary: \code{"both"} (default), \code{"model"}, or \code{"fit_adjusted"}.}
}
\value{
A named list with facet-statistics components. Class:
\code{mfrm_facet_statistics}.
}
\description{
Build a facet statistics report (preferred alias)
}
\details{
\code{summary(out)} is supported through \code{summary()}.
\code{plot(out)} is dispatched through \code{plot()} for class
\code{mfrm_facet_statistics} (\code{type = "means"}, \code{"sds"}, \code{"ranges"}).
}
\section{Interpreting output}{

\itemize{
\item facet-level means/SD/ranges of selected metrics (\code{Estimate}, fit indices, \code{SE}).
\item fixed-width ruler rows (\code{M/S/Q/X}) for compact profile scanning.
}
}

\section{Typical workflow}{

\enumerate{
\item Run \code{facet_statistics_report(fit)}.
\item Inspect summary/ranges for anomalous facets.
\item Cross-check flagged facets with fit and chi-square diagnostics.
The returned bundle now includes:
}
\itemize{
\item \code{precision_summary}: facet precision/separation indices by
\code{DistributionBasis} and \code{SEMode}
\item \code{variability_tests}: fixed/random variability tests by facet
\item \code{se_modes}: compact list of available SE modes by facet
}
}

\examples{
toy <- load_mfrmr_data("example_core")
fit <- fit_mfrm(toy, "Person", c("Rater", "Criterion"), "Score", method = "JML", maxit = 30)
out <- facet_statistics_report(fit)
summary(out)
p_fs <- plot(out, draw = FALSE)
p_fs$data$plot
}
\seealso{
\code{\link[=diagnose_mfrm]{diagnose_mfrm()}}, \code{\link[=summary.mfrm_fit]{summary.mfrm_fit()}}, \code{\link[=plot_facets_chisq]{plot_facets_chisq()}},
\link{mfrmr_reports_and_tables}
}
