% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/simulations.R
\name{simEstimatorFigures}
\alias{simEstimatorFigures}
\title{Estimator Comparison Figures: t2S/f2S vs z2S/chisq2S}
\usage{
simEstimatorFigures(
  sim.dir = "resiBootSim",
  figures.dir = NULL,
  alpha = 0.05,
  fixed.knots = FALSE
)
}
\arguments{
\item{sim.dir}{Character, directory containing simulation output with a
\code{sim_raw/} sub-directory.  Default \code{"resiBootSim"}.}

\item{figures.dir}{Character, output directory for PDFs.
Default \code{file.path(sim.dir, "figures", "estimator_compare")}.}

\item{alpha}{Numeric, nominal level (used only in figure titles). 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 estimator-comparison \code{data.frame}.
}
\description{
Reads the per-replicate raw \code{.rds} files from one simulation directory and
produces Bias + MSE comparison figures contrasting the RESI estimators actually
used for \code{lm} models against the simpler z-statistic / chi-squared alternatives:
\itemize{
  \item \strong{Coefficients table}: \code{\link{t2S}} (used) vs \code{\link{z2S}} (alternative)
  \item \strong{Anova table}: \code{\link{f2S}} (used) vs \code{\link{chisq2S}} (alternative)
}
Only \code{lm} models are included; GLM models are skipped because z2S and
chisq2S are the natural estimators there.
}
\seealso{
\code{\link{simCompareMethodsFigures}}, \code{\link{simRecomputeSummary}}
}
