% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/simulations.R
\name{simFigures}
\alias{simFigures}
\title{Simulation Performance Figures for RESI Evaluation}
\usage{
simFigures(output.dir = "resiBootSim", alpha = 0.05, ci.label = NULL)
}
\arguments{
\item{output.dir}{Character, directory containing simulation output from
\code{\link{insurancePlasmodeSim}}. Default \code{"resiBootSim"}.}

\item{alpha}{Numeric, nominal CI level used for the coverage reference line.
Default 0.05.}

\item{ci.label}{Character, label for the CI method used in figure titles and file
names. Default \code{NULL}, which auto-detects from \code{output.dir}:
\code{"boot"} if the directory name contains "Boot"/"boot",
\code{"normal"} if it contains "Normal"/"normal",
\code{"qf"} if it contains "QF"/"qf", otherwise \code{basename(output.dir)}.}
}
\value{
Invisibly returns the summary metrics \code{data.frame}. Saves PDF figures
  to \code{file.path(output.dir, "figures")}, named
  \code{sim_<model>_<vcov>_<ci.label>.pdf}.
}
\description{
Produces performance figures from the output of \code{\link{insurancePlasmodeSim}}.
Creates one PDF figure per (model type) \eqn{\times} (variance estimator) combination
(4 figures total by default). Each figure is a 2 \eqn{\times} 4 panel grid:
\itemize{
  \item \strong{Top row}: Anova-table RESI metrics (Bias, MSE, CI Coverage, CI Width)
  \item \strong{Bottom row}: Coefficients-table RESI metrics (same metrics; intercept excluded)
  \item \strong{Colors}: one colored line per model term (high-contrast matte palette)
  \item \strong{x-axis}: sample size on a log scale
}
Dashed reference lines are drawn at zero for Bias and at \eqn{1 - \alpha} for CI Coverage.
}
\seealso{
\code{\link{insurancePlasmodeSim}}
}
