metaplus: Fits random effects meta-analysis models, using either a...

View source: R/metaplus.R

metaplusR Documentation

Fits random effects meta-analysis models, using either a standard normal distribution, a t-distribution or a mixture of normals for the random effect.

Description

Allows fitting of random effects meta-analysis producing confidence intervals based on profile likelihood. Two methods of robust meta-analysis are included, based on either the t-distribution or normal-mixture distribution.

Usage

metaplus(yi, sei, mods = NULL, random = "normal", 
 label = switch(random, "normal" = "Random Normal", "t-dist" = "Random t-distribution", 
 "mixture" = "Random mixture"), 
 plotci = FALSE, justfit = FALSE, slab = 1:length(yi), 
 useAGQ = FALSE, quadpoints = 21, notrials = 20, 
 cores = max(detectCores()%/%2, 1), data)

Arguments

yi

vector of observed effect size

sei

vector of observed standard errors (note: not standard errors squared)

mods

data frame of covariates corresponding to each study

random

The type of random effects distribution. One of "normal", "t-dist", "mixture", for standard normal, t-distribution or mixture of normals respectively.

label

The label to be used for this model when plotting

plotci

Should profile be plotted for each confidence interval?

justfit

Should model only be fitted? If justfit = TRUE then profiling and likelihood ratio statistics are not calculated. Useful for when bootstrapping.

slab

Vector of character strings corresponding to each study.

useAGQ

Deprecated. No longer used.

quadpoints

Deprecated. No longer used.

notrials

Number of random starting values to use for mixture models.

cores

Number of rcores to use for parallel processing of .

data

Optional data frame containing some or all other data.

Details

As well as standard normal random effects meta-analysis, fitting of robust models incorporating either a t-distribution random effect (Lee and Thompson, 2008 or Baker and Jackson, 2008) or a mixture of normals (Beath, 2014) may be fitted. For all models the profile log-likelihood (Hardy and Thompson, 1996) is used to determine the confidence intervals for the parameters, with corresponding p values calculated using the likelihood ratio test, to give consistency between the confidence intervals and p values. The profile log-likelihood produces confidence intervals with better properties than REML or Der Simonian-Laird method (Brockwell and Gordon 2001, Jackson et al 2010)

For the mixture normal model, multiple starting values are used. This is achieved by starting with the no outlier model, then all possible single outlier models and choosing the model with the maximum likelihood. The process is repeated by adding all possible outliers to obtain the two outlier models and the maximum likelihood chosen. The process is repeated until the likelihood is not further maximised by adding outliers. This method gives a faster fitting time and is more reliable than using random assignments, as we have usually only a small number of outliers.

Value

results

Matrix containing columns for estimate, lower 95%, upper 95% and p value, or if justfit = TRUE then only the parameter estimates

yi

Effect sizes

sei

Standard error of effect sizes

mods

Modifiers for meta-regression

slab

Study labels

justfit

Value of justfit passed to the method.

fittedmodel

final model returned by mle2

profile

profile likelihood returned as described in bbmle

random

Type of random effect

outlier.prob

Outlier probabilities for robust mixture model only

Note

I have used cores = 1 in the examples, as this is required by some of the checking procedures but it can, and should be, be removed for your own use for faster execution.

Author(s)

Ken Beath <ken.beath@mq.edu.au>

References

Baker, R., & Jackson, D. (2008). A new approach to outliers in meta-analysis. Health Care Management Science, 11(2), 121131.

Beath, K. J. (2014). A finite mixture method for outlier detection and robustness in meta-analysis. Research Synthesis Methods, 5, 285-293. doi:10.1002/jrsm.1114

Brockwell, S. E., & Gordon, I. R. (2001). A comparison of statistical methods for meta-analysis. Statistics in Medicine, 20, 825-840.

Hardy, R. J., & Thompson, S. G. (1996). A likelihood approach to meta-analysis with random effects. Statistics in Medicine, 15, 619-629.

Jackson, D., Bowden, J., & Baker, R. (2010). How does the DerSimonian and Laird procedure for random effects meta-analysis compare with its more efficient but harder to compute counterparts? Journal of Statistical Planning and Inference, 140, 961-970. doi:10.1016/j.jspi.2009.09.017

Lee, K. J., & Thompson, S. G. (2008). Flexible parametric models for random effects distributions. Statistics in Medicine, 27, 418-434. doi:10.1002/sim

Examples


library(metaplus)

# perform meta-analysis for mag studies, which have no outliers
# fit standard normal random-effect model and print summary
mag.meta <- metaplus(yi, sei, slab = study, data = mag)
summary(mag.meta)
# repeat, but this time plot the profile likelihood diagnostic plot using plotci
mag.meta <- metaplus(yi, sei, slab = study, plotci = TRUE, cores = 1, data = mag)
# plot a forest plot with exponential transform, so that the odds ratios are plotted
plot(mag.meta, atransf = exp, at = log(c(.01, .1, 1, 10, 100)), xlab = "Odds Ratio", 
 cex = 0.75)
# repeat for t-distribution random effects
mag.tdist <- metaplus(yi, sei, slab = study, 
 random = "t-dist", cores = 1, data = mag)
summary(mag.tdist)
# use parametric bootstrap to test for presence of outliers
summary(testOutliers(mag.tdist, cores = 1))
# repeat for robust mixture random effects
mag.mix <- metaplus(yi, sei, slab = study, 
 random = "mixture", cores = 1, data = mag)
summary(mag.mix)
# use parametric bootstrap to test for presence of outliers
summary(testOutliers(mag.mix, cores = 1))


# perform meta-analysis for CDP studies
# where there is one outlier
cdp.meta <- metaplus(yi, sei, slab = study, cores = 1, data = cdp)
summary(cdp.meta)
cdp.tdist <- metaplus(yi, sei, slab = study, 
 random = "t-dist", cores = 1, data = cdp)
summary(cdp.tdist)
summary(testOutliers(cdp.tdist, cores = 1))
cdp.mix <- metaplus(yi, sei, slab = study, 
 random = "mixture", cores = 1, data = cdp)
summary(cdp.mix)
summary(testOutliers(cdp.mix, cores = 1))

# extract and plot outlier probabilities
cdp.mix.outlierProbs <- outlierProbs(cdp.mix)
plot(cdp.mix.outlierProbs)

# produce forest plot with summary for all 3 models, showing narrower confidence
# intervals for robust models
plot(cdp.meta, extrameta = list(cdp.tdist, cdp.mix), xlab = "Standardised Mean Difference")


# effect of exercise on depression with covariate of length of study
# fit the 3 models
exercise.meta <- metaplus(smd, sqrt(varsmd), 
 mods = duration, slab = study, cores = 1, data = exercise)
summary(exercise.meta)
exercise.mix <- metaplus(smd, sqrt(varsmd), 
 mods = duration, slab = study, random = "mixture", 
 cores = 1, data = exercise)
summary(exercise.mix)
exercise.testOutliers <- testOutliers(exercise.mix, cores = 1)
summary(exercise.testOutliers)

# identify possible outliers
exercise.outlierProbs <- outlierProbs(exercise.mix)
plot(exercise.outlierProbs)

# centre duration at different values to obtain predictions at 4, 8 and 12 weeks 
exercise$duration4 <- exercise$duration-4
exercise$duration8 <- exercise$duration-8
exercise$duration12 <- exercise$duration-12

# fit the different models, giving each an appropriate label
exercise.nodurn <- metaplus(smd, sqrt(varsmd), 
 label = "Random Mixture (No Duration)", slab = study, 
 random = "mixture", cores = 1, data = exercise)
exercise.wk4 <- metaplus(smd, sqrt(varsmd), 
 mods = duration4, label = "Random Mixture (Week 4)", 
 slab = study, random = "mixture", cores = 1, data = exercise)
exercise.wk8 <- metaplus(smd, sqrt(varsmd), 
 mods = duration8, label = "Random Mixture (Week 8)", 
 slab = study, random = "mixture", cores = 1, data = exercise)
exercise.wk12 <- metaplus(smd, sqrt(varsmd), 
 mods = duration12, label = "Random Mixture (Week 12)", 
 slab = study, random = "mixture", cores = 1, data = exercise)
 
# produce forest plot with summary for each model with robust mixture model at different weeks
plot(exercise.nodurn, extrameta = list(exercise.wk4, exercise.wk8, 
 exercise.wk12), xlab = "Standardised mean difference")


metaplus documentation built on May 13, 2022, 9:07 a.m.