ranefDiagnostics: Diagnostics of random effects of the linear mixed model

View source: R/ranefDiagnostics.R

ranefDiagnosticsR Documentation

Diagnostics of random effects of the linear mixed model

Description

ranefDiagnostics provides several plots as well as statistical test for the examination of the normality of the random effects of the input model.

Usage

ranefDiagnostics(model, verbose = TRUE)

Arguments

model

An object of class "lme" representing the linear mixed-effects model fitted by lmmModel().

verbose

Logical indicating if the normality and homoscedasticity tests results should be printed to the console.

Details

One of the assumptions of the model obtained with lmmModel() (as in any other linear mixed model) is that the random effects are normally distributed:

b_i = N(0,\psi)

For the evaluation of this assumption, ranefDiagnostics provides Q-Q plots of random effects, together with statistical assessment of their normality using Shapiro-Wilk, D'Agostini and Anderson-Darling normality tests. Additionally, Q-Q plots of the normalized residuals (standardized residuals pre-multiplied by the inverse square-root factor of the estimated error correlation matrix, see nlme::residuals.lme) by sample are provided to allow for the identification of subjects which could be notably different from the others and be affecting the adequacy of the model. Additionally, boxplots of the "raw" residuals (observed - fitted) by sample and scatter plots of the normalized residuals versus fitted values by sample are provided to give information about variability of the residuals by subject and possible outlier observations. Observations with absolute standardized (normalized) residuals greater than the 1-0.05/2 quantile of the standard normal distribution are identified in the scatter plots labelled with the time point corresponding to the observation.

Value

A list with different elements for the diagnostics of the random effects are produced:

  • plots: Different plots for evaluating the normality and homoscedasticity of the random effects are produced.

  • Normality: List with the results from 3 different test of the normality of the random effects: Shapiro - Wilk normality test, D'Agostino normality test and Anderson - Darling normality test.

  • Levene.test: results from Levene homoscedasticity test (car::leveneTest()) of the normalized residuals by SampleID (i.e., by subject).

  • Fligner.test: results from Fligner homoscedasticity test (stats::fligner.test()) of the normalized residuals by SampleID (i.e., by subject).

References

  • Pinheiro JC, Bates DM (2000). Mixed-Effects Models in S and S-PLUS. Springer, New York. \Sexpr[results=rd]{tools:::Rd_expr_doi("doi:10.1007/b98882")}.

  • Andrzej Galecki & Tomasz Burzykowski (2013) Linear Mixed-Effects Models Using R: A Step-by-Step Approach First Edition. Springer, New York. ISBN 978-1-4614-3899-1

See Also

plot_ranefDiagnostics()

Examples

# Load the example data
data(grwth_data)
# Fit the model
lmm <- lmmModel(
  data = grwth_data,
  sample_id = "subject",
  time = "Time",
  treatment = "Treatment",
  tumor_vol = "TumorVolume",
  trt_control = "Control",
  drug_a = "DrugA",
  drug_b = "DrugB",
  combination = "Combination"
  )
# Run random effects diagnostics
ranef_diag <- ranefDiagnostics(lmm)

#Access to individual plots

ranef_diag$Plots[1]
ranef_diag$Plots[2]

# Access to normality tests

ranef_diag$Normality

ranef_diag$Normality$Shapiro.test

# Access to homoscedasticity tests of residuals by subject

ranef_diag$Levene.test

ranef_diag$Fligner.test


SynergyLMM documentation built on April 4, 2025, 4:13 a.m.