Methods implemented in package 'broom' to tidy, glance and augment the output
from model fits return a consistently organized tibble with generic column
names. Although this simplifies later steps in the data analysis and
reporting, it drops key information needed for interpretation.
keep_tidy()
makes it possible to retain fields from the model fit
object passed as argument to parameter x
in the attribute "fm"
.
The class of x
is always stored, and by default also fields
"call"
, "terms"
, "formula"
, "fixed"
and
"random"
if available.
Details
Functions keep_tidy()
, keep_glance
or
keep_augment
are simple wrappers of the generic methods which make
it possible to add to the returned values an attribute named "fm"
preserving user selected fields and class of the model fit object. Fields
names in to.keep
missing in x
are silently ignored.
Examples
# these examples can only be run if package 'broom' is available
if (requireNamespace("broom", quietly = TRUE)) {
library(broom)
mod <- lm(mpg ~ wt + qsec, data = mtcars)
attr(keep_tidy(mod), "fm")[["class"]]
attr(keep_glance(mod), "fm")[["class"]]
attr(keep_augment(mod), "fm")[["class"]]
attr(keep_tidy(summary(mod)), "fm")[["class"]]
library(MASS)
rmod <- rlm(mpg ~ wt + qsec, data = mtcars)
attr(keep_tidy(rmod), "fm")[["class"]]
}
#> [1] "rlm" "lm"