Skip to contents

Runs a compact grid of coverage simulation cases and optionally writes CSV, RDS, and LaTeX summary outputs for reviewer inspection.

Usage

run_coverage_simulations(
  families = NULL,
  copulas = c("N", "C", "F", "G", "J", "t"),
  methods = .coverage_default_methods(),
  designs = "intercept",
  include_mixed = FALSE,
  output_dir = file.path("results", "coverage_simulations"),
  write_results = TRUE,
  write_summary = TRUE,
  compile_summary_pdf = FALSE,
  smooth_results_file = NULL,
  report_title = "Coverage Simulation Summary",
  ...
)

Arguments

families

Character vector of margin families to include. When NULL, the default coverage families are used.

copulas

Character vector of copula families to include.

methods

Character vector of fitting methods to include.

designs

Character vector of simulation designs to include.

include_mixed

Include mixed discrete/continuous cases when TRUE.

output_dir

Directory for CSV/RDS outputs.

write_results

Write result files when TRUE.

write_summary

Write a LaTeX summary report when TRUE and write_results is also TRUE.

compile_summary_pdf

Compile the LaTeX summary to PDF when TRUE and a LaTeX installation is available.

smooth_results_file

Optional smooth smoke-test CSV to include in the generated summary report.

report_title

Title for the generated summary report.

...

Passed to the grid runner, e.g. n, times, max_outer_iter, dependence, missingness, and start_mode.

Value

A data frame of per-fit results. The return value also carries "parameter_results" and "runtime_summary" attributes.