% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/ild_compare_fits.R
\name{ild_compare_fits}
\alias{ild_compare_fits}
\title{Compare fitted models (AIC, BIC, nobs)}
\usage{
ild_compare_fits(fits, guardrail_bundles = NULL)
}
\arguments{
\item{fits}{A named (or unnamed) list of fitted model objects.}

\item{guardrail_bundles}{Optional named list of [ild_diagnostics_bundle] objects
aligned with \code{fits} (same length and order). When provided, adds
\code{n_guardrails} per row.}
}
\value{
A tibble with columns \code{model}, \code{engine} (from [ild_methods()]
  truncated to one line when long), \code{aic}, \code{bic}, \code{n_obs},
  \code{converged} (best-effort), \code{n_guardrails} (if bundles given),
  and \code{notes} (fit-specific caveats).
}
\description{
Builds a compact comparison table for a named list of fitted objects.
Uses [stats::AIC()], [stats::BIC()], and [stats::nobs()] where those methods
exist. This is **not** a likelihood-ratio test and does not establish that
models are nested; interpret only when model comparison is scientifically
appropriate for your estimand.
}
\seealso{
\code{vignette("temporal-dynamics-model-choice", package = "tidyILD")}.
}
