% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/api-simulation.R
\name{plot.mfrm_diagnostic_screening}
\alias{plot.mfrm_diagnostic_screening}
\title{Plot a diagnostic-screening validation study}
\usage{
\method{plot}{mfrm_diagnostic_screening}(
  x,
  type = c("overview", "report", "contrast", "runtime"),
  metric = NULL,
  x_var = c("n_person", "n_rater", "n_criterion", "raters_per_person"),
  group_var = NULL,
  draw = TRUE,
  ...
)
}
\arguments{
\item{x}{Output from \code{\link[=evaluate_mfrm_diagnostic_screening]{evaluate_mfrm_diagnostic_screening()}}.}

\item{type}{Plot family. \code{"overview"} combines screening and optional report
rates or counts. \code{"report"} focuses on \code{mfrm_report()} review signals.
\code{"contrast"} plots misspecification-minus-well-specified contrasts.
\code{"runtime"} plots elapsed-time summaries.}

\item{metric}{Metric family. Use \code{NULL} or \code{"auto"} for the default within
each \code{type}. Supported values are documented by error messages and include
\code{"rate"}, \code{"count"}, \code{"magnitude"}, \code{"elapsed"}, and
\code{"per_observation"} depending on \code{type}.}

\item{x_var}{Design variable for the horizontal axis. Public design aliases
from a simulation specification are accepted.}

\item{group_var}{Optional additional design variable to include in group
labels. Public design aliases are accepted.}

\item{draw}{Logical; if \code{FALSE}, return the plot-data bundle without drawing.}

\item{...}{Reserved for future extensions.}
}
\value{
An \code{mfrm_plot_data} object with reusable metadata, a long-form
\code{plot_long} table, and interpretation handoff tables (\code{overview},
\code{reading_order}, \code{next_actions}, \code{reporting_notes}, and
\code{figure_recipes}). When \code{draw = TRUE}, the object is returned invisibly
after drawing.
}
\description{
Builds an integrated visual summary from
\code{\link[=evaluate_mfrm_diagnostic_screening]{evaluate_mfrm_diagnostic_screening()}} output. The default view combines
legacy residual, strict marginal, strict pairwise, strict combined, and
optional report-index review rates so simulation results can be inspected in
one operating-characteristic surface.
}
\examples{
\donttest{
diag_eval <- evaluate_mfrm_diagnostic_screening(
  design = list(person = 10, rater = 2, criterion = 2, assignment = 2),
  reps = 1,
  maxit = 30,
  include_report = TRUE,
  seed = 123
)
plot(diag_eval, type = "overview", draw = FALSE)
plot_data(diag_eval, type = "overview", component = "plot_long")
plot_data(diag_eval, type = "overview", component = "next_actions")
plot_data(diag_eval, type = "overview", component = "figure_recipes")
plot(diag_eval, type = "report", metric = "rate", draw = FALSE)
}
}
