% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/simulations.R
\name{simCompareMethodsFigures}
\alias{simCompareMethodsFigures}
\title{Per-Term CI Method Comparison Figures}
\usage{
simCompareMethodsFigures(
  output.dirs = c(Bootstrap = "resiBootSim", Normal = "resiAsympNormalSim", QF =
    "resiAsympQFSim", CF = "resiAsympCFSim"),
  figures.dir = NULL,
  alpha = 0.05,
  fixed.knots = FALSE
)
}
\arguments{
\item{output.dirs}{Named character vector mapping CI method labels to their
simulation output directories. Default:
\code{c(boot = "resiBootSim", normal = "resiAsympNormalSim",
qf = "resiAsympQFSim", cf = "resiAsympCFSim")}.
Directories that do not exist are silently skipped.}

\item{figures.dir}{Character, directory where comparison figures are saved.
Default: \code{file.path(output.dirs[1], "figures", "method_comparison")}.}

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

\item{fixed.knots}{Logical. Must match the value used in the original
\code{\link{insurancePlasmodeSim}} call. Default \code{FALSE}.}
}
\value{
Invisibly returns the combined summary \code{data.frame}. Saves
  \code{estimator_<model>_<vcov>_<table>.pdf},
  \code{compare_<model>_<vcov>_<table>.pdf}, and
  \code{covquant_<model>_<vcov>_<table>.pdf} to \code{figures.dir}.
}
\description{
Reads simulation summary tables from multiple output directories (one per CI
method) and produces PDF figures comparing CI methods across sample sizes.
For each (model type x variance estimator x table) combination two PDFs are
saved: an estimator comparison (Bias, MSE) and a CI comparison (SE
calibration, coverage, width).
}
\seealso{
\code{\link{insurancePlasmodeSim}}, \code{\link{simFigures}},
  \code{\link{simEstimatorFigures}}
}
