metafor: A Meta-Analysis Package for R
Description
The metafor
package is a comprehensive collection of functions for conducting meta-analyses in R. The package includes functions to calculate various effect sizes or outcome measures, fit equal-, fixed-, random-, and mixed-effects models to such data, carry out moderator and meta-regression analyses, and create various types of meta-analytical plots (e.g., forest, funnel, radial, L'Abbé, Baujat, bubble, and GOSH plots). For meta-analyses of binomial and person-time data, the package also provides functions that implement specialized methods, including the Mantel-Haenszel method, Peto's method, and a variety of suitable generalized linear (mixed-effects) models (i.e., mixed-effects logistic and Poisson regression models). Finally, the package provides functionality for fitting meta-analytic multivariate/multilevel models that account for non-independent sampling errors and/or true effects (e.g., due to the inclusion of multiple treatment studies, multiple endpoints, or other forms of clustering). Network meta-analyses and meta-analyses accounting for known correlation structures (e.g., due to phylogenetic relatedness) can also be conducted.
Package Website
The metafor
package website can be found at https://www.metafor-project.org. On the website, you can find:
- some news concerning the package and/or its development,
- a more detailed description of the package features,
- a log of the package updates that have been made over the years,
- a to-do list and a description of planned features to be implemented in the future,
- information on how to download and install the package,
- information on how to obtain documentation and help with using the package,
- some analysis examples that illustrate various models, methods, and techniques,
- a little showcase of plots and figures that can be created with the package,
- some tips and notes that may be useful when working with the package,
- a list of people that have in some shape or form contributed to the development of the package,
- a frequently asked questions section, and
- some links to other websites related to software for meta-analysis.
Documentation
A good starting place for those interested in using the metafor
package is the following paper:
Viechtbauer, W. (2010). Conducting meta-analyses in R with the metafor package. Journal of Statistical Software, 36(3), 1-48. https://doi.org/10.18637/jss.v036.i03
In addition to reading the paper, carefully read the package intro and then the help pages for the escalc
and the rma.uni
functions (or the rma.mh
, rma.peto
, rma.glmm
, rma.mv
functions if you intend to use these methods). The help pages for these functions provide links to many additional functions, which can be used after fitting a model. You can also read the entire documentation online at https://wviechtb.github.io/metafor/ (where it is nicely formatted, equations are shown correctly, and the output from all examples is provided).
Installation
The current official (i.e., CRAN) release can be installed within R with:
install.packages("metafor")
The development version of the package can be installed with:
install.packages("remotes")
remotes::install_github("wviechtb/metafor")
This builds the package from source based on the current version on GitHub.
Meta
The metafor package was written by Wolfgang Viechtbauer. It is licensed under the GNU General Public License. For citation info, type citation(package='metafor')
in R. To report any issues or bugs or to suggest enhancements to the package, please go here.