internal function to check the sanity of user input
sanity_checks(models, statistic = "std.error",
statistic_override = NULL, conf_level = 0.95, coef_map = NULL,
coef_omit = NULL, gof_map = NULL, gof_omit = NULL, fmt = "%.3f",
stars = NULL, stars_note = TRUE, title = NULL, subtitle = NULL,
notes = NULL, add_rows = NULL, filename = NULL)
a single model object or a (potentially named) list of models to summarize
string name of the statistic to include in parentheses below estimates. Must be either "conf.int", or one of the column names produced by the `broom::tidy` function. Typical values include: "std.error", "conf.int", "statistic", "p.value".
manually override the uncertainy estimates. This argument accepts three types of input:
a function or list of functions of length(models) which produce variance-covariance matrices with row and column names equal to the names of your coefficient estimates. For example, `R` supplies the `vcov` function, and the `sandwich` package supplies `vcovHC`, `vcovHAC`, etc.
a list of length(models) variance-covariance matrices with row and column names equal to the names of your coefficient estimates.
a list of length(models) numeric vectors with names equal to the names of your coefficient estimates.
confidence level to use for confidence intervals
named character vector. Names refer to the original variable names. Values refer to the variable names that will appear in the table. Coefficients which are omitted from this vector will be omitted from the table. The table will be ordered in the same order as this vector.
string regular expression. Omits all matching coefficients from the table (using `stringr::str_detect`).
data.frame with four columns: `raw`, `clean`, `fmt`, and `omit`. See `modelsummary::gof_map`
string regular expression. Omits all matching gof statistics from the table (using `stringr::str_detect`).
string which specifies how numeric values will be rounded. This string is passed to the `sprintf` function. '%.3f' will keep 3 digits after the decimal point with trailing zero. '%.5f' will keep 5 digits. '%.3e' will use exponential notation. See `?sprintf` for more options.
FALSE for no significance stars. TRUE for default significance stars (*=.1, **=.05, ***=.01). Named numeric vector for custom significance stars. For example, `c('*' = .1, '+' = .05)`
logical include a note at the bottom of the table to describe the contents of the `stars` argument. The note will be omitted if `stars==NULL`
string
string
list of notes to append to the bottom of the table.
list of character vectors, each of length equal to the number of models + 1.
the file name to create on disk. Ensure that an extension compatible with the output types is provided (`.html`, `.tex`, `.ltx`, `.rtf`). Read `?gt::gtsave` for further details. When the table produced by `modelsummary` is post-processed by another `gt` function, users need to use the `gtsave` function from the `gt` package; using the `filename` argument will produce an error.
error if sanity checks fail