emmeans: as.emmGrid – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

as.emmGrid

Convert to and from emmGrid objects

Description

These are useful utility functions for creating a compact version of an emmGrid object that may be saved and later reconstructed, or for converting old ref.grid or lsmobj objects into emmGrid objects.

Usage

## S3 method for class 'emmGrid'
as.list(x, model.info.slot = FALSE, ...)

as.emm_list(object, ...)

as.emmGrid(object, ...)

Arguments

`x`	An `emmGrid` object
`model.info.slot`	Logical value: Include the `model.info` slot? Set this to `TRUE` if you want to preserve the original call and information needed by the `submodel` option. If `FALSE`, only the nesting information (if any) is saved
`...`	In `as.emmGrid`, additional arguments passed to `update.emmGrid` before returning the object. This argument is ignored in `as.list.emmGrid`
`object`	Object to be converted to class `emmGrid`. It may be a `list` returned by `as.list.emmGrid`, or a `ref.grid` or `lsmobj` object created by emmeans's predecessor, the lsmeans package. An error is thrown if `object` cannot be converted.

Details

An emmGrid object is an S4 object, and as such cannot be saved in a text format or saved without a lot of overhead. By using as.list, the essential parts of the object are converted to a list format that can be easily and compactly saved for use, say, in another session or by another user. Providing this list as the arguments for emmobj allows the user to restore a working emmGrid object.

Value

as.list.emmGrid returns an object of class list.

as.emm_list returns an object of class emm_list.

as.emmGrid returns an object of class emmGrid. However, in fact, both as.emmGrid and as.emm_list check for an attribute in object to decide whether to return an emmGrid or emm_list) object.

Examples

pigs.lm <- lm(log(conc) ~ source + factor(percent), data = pigs)
pigs.sav <- as.list(ref_grid(pigs.lm))

pigs.anew <- as.emmGrid(pigs.sav)
emmeans(pigs.anew, "source")

emmeans

Estimated Marginal Means, aka Least-Squares Means

v1.6.0

GPL-2 | GPL-3

Authors

Russell V. Lenth [aut, cre, cph], Paul Buerkner [ctb], Maxime Herve [ctb], Jonathon Love [ctb], Hannes Riebl [ctb], Henrik Singmann [ctb]

Initial release

2021-04-25