% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/api-simulation.R
\name{plot.mfrm_recovery_simulation}
\alias{plot.mfrm_recovery_simulation}
\title{Plot parameter-recovery simulation results}
\usage{
\method{plot}{mfrm_recovery_simulation}(
  x,
  y = NULL,
  type = c("summary", "coverage", "errors", "scatter", "replications"),
  metric = c("rmse", "bias", "mae", "correlation", "coverage", "mcse_bias", "mcse_rmse",
    "raw_rmse", "raw_bias", "mean_se", "se_available"),
  parameter_type = NULL,
  facet = NULL,
  comparison = c("aligned", "unaligned"),
  draw = TRUE,
  ...
)
}
\arguments{
\item{x}{Output from \code{\link[=evaluate_mfrm_recovery]{evaluate_mfrm_recovery()}}.}

\item{y}{Reserved for S3 generic compatibility.}

\item{type}{Plot route: \code{"summary"} draws a metric from
\code{x$recovery_summary}, \code{"coverage"} draws 95\% coverage by parameter group,
\code{"errors"} draws row-level recovery-error distributions, \code{"scatter"} draws
truth against estimated values, and \code{"replications"} summarizes run status.}

\item{metric}{Summary metric used when \code{type = "summary"}. Supported values
are \code{"rmse"}, \code{"bias"}, \code{"mae"}, \code{"correlation"}, \code{"coverage"},
\code{"mcse_bias"}, \code{"mcse_rmse"}, \code{"raw_rmse"}, \code{"raw_bias"}, \code{"mean_se"}, and
\code{"se_available"}.}

\item{parameter_type}{Optional parameter type filter, such as \code{"person"},
\code{"facet"}, \code{"step"}, \code{"slope"}, or \code{"population"}.}

\item{facet}{Optional facet filter.}

\item{comparison}{Error/estimate scale for row-level routes. \code{"aligned"}
uses \code{EstimateAligned} / \code{ErrorAligned}; \code{"unaligned"} uses \code{Estimate} /
\code{ErrorRaw} on the same comparison scale.}

\item{draw}{If \code{TRUE}, draw with base graphics. If \code{FALSE}, return an
\code{mfrm_plot_data} object with reusable plot tables and metadata.}

\item{...}{Reserved for future extensions.}
}
\value{
An \code{mfrm_plot_data} object. When \code{draw = TRUE}, the object is returned
invisibly after drawing.
}
\description{
Plot parameter-recovery simulation results
}
\details{
These plots are intended as simulation-review graphics. They do not replace
the row-level \code{x$recovery} table or the ADEMP metadata; they make the main
recovery estimands easier to inspect during model-development and design
checks. Coverage is displayed only for parameter groups with available
standard errors.
}
\examples{
\donttest{
rec <- evaluate_mfrm_recovery(
  n_person = 12,
  n_rater = 2,
  n_criterion = 2,
  reps = 1,
  maxit = 30,
  seed = 123
)
plot(rec, type = "summary", metric = "rmse", draw = FALSE)
}
}
\seealso{
\code{\link[=evaluate_mfrm_recovery]{evaluate_mfrm_recovery()}}, \code{\link[=summary]{summary()}}
}
