% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/api-simulation.R
\name{summary.mfrm_diagnostic_screening}
\alias{summary.mfrm_diagnostic_screening}
\title{Summarize a diagnostic-screening validation study}
\usage{
\method{summary}{mfrm_diagnostic_screening}(object, digits = 3, ...)
}
\arguments{
\item{object}{Output from \code{\link[=evaluate_mfrm_diagnostic_screening]{evaluate_mfrm_diagnostic_screening()}}.}

\item{digits}{Number of digits used in numeric summaries.}

\item{...}{Reserved for generic compatibility.}
}
\value{
An object of class \code{summary.mfrm_diagnostic_screening} with:
\itemize{
\item \code{overview}: run-level design, replication, convergence, and report-review
metadata
\item \code{reading_order}: recommended order for reading the summary tables
\item \code{next_actions}: action-oriented triage for interpreting and exporting the
summary
\item \code{reporting_notes}: report-facing boundaries and recommended wording
safeguards
\item \code{figure_recipes}: recommended figure/display recipes for the draw-free
plot-data tables
\item \code{scenario_summary}: aggregated scenario-by-design screening summaries
\item \code{performance_summary}: operating-characteristic rates and runtime summaries
\item \code{report_signal_summary}: optional \code{mfrm_report()} readiness/review signals
\item \code{scenario_contrast}: misspecification-minus-well-specified contrasts
\item \verb{plot_*}: long-form draw-free plot tables for overview, report, contrast,
and runtime views
\item planning metadata, settings, ADEMP metadata, and interpretation notes
}
}
\description{
Summarizes output from \code{\link[=evaluate_mfrm_diagnostic_screening]{evaluate_mfrm_diagnostic_screening()}} for reporting,
appendix export, and draw-free visualization handoff. The summary keeps
simulation operating characteristics separate from validation gates: fit,
marginal, pairwise, and report-review signals are screening readouts rather
than pass/fail evidence.
}
\examples{
\donttest{
diag_eval <- evaluate_mfrm_diagnostic_screening(
  design = list(person = 10, rater = 2, criterion = 2, assignment = 2),
  reps = 1,
  maxit = 30,
  seed = 123
)
summary(diag_eval)
}
}
\seealso{
\code{\link[=evaluate_mfrm_diagnostic_screening]{evaluate_mfrm_diagnostic_screening()}}, \link{plot.mfrm_diagnostic_screening}, \code{\link[=plot_data]{plot_data()}}
}
