07complete: Extract the Completed Data

07completeR Documentation

Extract the Completed Data


This function extracts several multiply imputed data.frames from an object of mi-class.


complete(y, m, ...)



An object of mi-class (typically) or missing_data.frame-class or missing_variable-class


If y is an object of mi-class, then m must be a specified integer indicating how many multiply imputed data.frames to return or, if missing, the number of data.frames will be equal to the length of the data slot in y. If y is not an object of mi-class, then m must be a specified integer indicating which iteration to use in the resulting data.frame, where any non-positive integer is a short hand for the last iteration.


Other arguments, not currently utilized


Several functions within mi use complete, although the only reason in principle why a user should need to call complete is to create data.frames to export to another program. For analysis, it is better to use the pool function, although currently pool might not offer all the necessary functionality.


If y is an object of mi-class and m > 1, a list of m data.frames is returned. Otherwise, a single data.frame is returned.


Ben Goodrich and Jonathan Kropko, for this version, based on earlier versions written by Yu-Sung Su, Masanao Yajima, Maria Grazia Pittau, Jennifer Hill, and Andrew Gelman.

See Also



if(!exists("imputations", env = .GlobalEnv)) {
  imputations <- mi:::imputations # cached from example("mi-package")
data.frames <- complete(imputations, 3)
lapply(data.frames, summary)

mi documentation built on June 7, 2022, 1:04 a.m.