resid_bootstrap: Residual Bootstrap for Nested LMEs

View source: R/generics.R

resid_bootstrap.merModR Documentation

Residual Bootstrap for Nested LMEs


Generate semi-parametric residual bootstrap replicates of a statistic for a nested linear mixed-effects model.


## S3 method for class 'merMod'
resid_bootstrap(model, .f, B, .refit = TRUE)

## S3 method for class 'lme'
resid_bootstrap(model, .f, B, .refit = TRUE)

resid_bootstrap(model, .f, B, .refit = TRUE)



The model object you wish to bootstrap.


A function returning the statistic(s) of interest.


The number of bootstrap resamples.


a logical value indicating whether the model should be refit to the bootstrap resample, or if the simulated bootstrap resample should be returned. Defaults to TRUE.


The semi-parametric bootstrap algorithm implemented was outlined by Carpenter, Goldstein and Rasbash (2003), and is referred to as the CGR bootstrap by some. The algorithm is outlined below:

  1. Obtain the parameter estimates from the fitted model and calculate the estimated error terms and EBLUPs.

  2. Center and rescale the error terms and EBLUPs so that the empirical variance of these quantities is equal to estimated variance components from the model.

  3. Sample independently with replacement from the rescaled estimated error terms and rescaled EBLUPs.

  4. Obtain bootstrap samples by combining the samples via the fitted model equation.

  5. Refit the model and extract the statistic(s) of interest.

  6. Repeat steps 3-5 B times.


The returned value is an object of class "lmeresamp".


Carpenter, J. R., Goldstein, H. and Rasbash, J. (2003) A novel bootstrap procedure for assessing the relationship between class size and achievement. Journal of the Royal Statistical Society. Series C (Applied Statistics), 52, 431–443.

See Also

  • Examples are given in bootstrap

  • parametric_bootstrap, resid_bootstrap, case_bootstrap, reb_bootstrap, wild_bootstrap for more details on a specific bootstrap.

  • bootMer in the lme4 package for an implementation of (semi-)parametric bootstrap for mixed models.

lmeresampler documentation built on April 30, 2022, 1:06 a.m.