Function to dynamically generate an analysis report for objects of class "rma.uni".

reporter(x, ...)

# S3 method for rma.uni
reporter(x, dir, filename, format="html_document", open=TRUE,
         digits, forest, funnel, footnotes=FALSE, verbose=TRUE, ...)



an object of class "rma.uni".


optional character string to specify the directory for creating the report. If unspecified, tempdir will be used.


optional character string to specify the filename (without file extension) for the report. If unspecified, the function sets a filename automatically.


output format for the report (either html_document, pdf_document, or word_document). Can be abbreviated. See ‘Note’.


logical to specify whether the report should be opened after it has been generated (the default is TRUE). See ‘Note’.


optional integer to specify the number of decimal places to which the printed results should be rounded. If unspecified, the default is to take the value from the object.


either a logical which will suppress the drawing of the forest plot when set to FALSE or a character string with arguments to be added to the call to forest for generating the forest plot.


either a logical which will suppress the drawing of the funnel plot when set to FALSE or a character string with arguments to be added to the call to funnel for generating the funnel plot.


logical to specify whether additional explanatory footnotes should be added to the report (the default is FALSE).


logical to specify whether information on the progress of the report generation should be provided (the default is TRUE).


other arguments.


The function dynamically generates an analysis report based on the model object. The report includes information about the model that was fitted, the distribution of the observed effect sizes or outcomes, the estimate of the average outcome based on the fitted model, tests and statistics that are informative about potential (residual) heterogeneity in the outcomes, checks for outliers and/or influential studies, and tests for funnel plot asymmetry. By default, a forest plot and a funnel plot are also provided (these can be suppressed by setting forest=FALSE and/or funnel=FALSE).


The function generates either a html, pdf, or docx file and returns (invisibly) the path to the generated document.


Since the report is created based on an R Markdown document that is generated by the function, the rmarkdown package and pandoc must be installed.

To render the report into a pdf document (i.e., using format="pdf_document") requires a LaTeX installation. If LaTeX is not already installed, you could try using the tinytex package to install a lightweight LaTeX distribution based on TeX Live.

Once the report is generated, the function opens the output file (either a .html, .pdf, or .docx file) with an appropriate application (if open=TRUE). This will only work when an appropriate application for the file type is installed and associated with the extension.

If filename is unspecified, the default is to use report, followed by an underscore (i.e., _) and the name of the object passed to the function. Both the R Markdown file (with extension .rmd) and the actual report (with extension .html, .pdf, or .docx) are named accordingly. To generate the report, the model object is also saved to a file (with the same filename as above, but with extension .rdata). Also, files references.bib and apa.csl are copied to the same directory (these files are needed to generate the references in APA format).

Since the report is put together based on predefined text blocks, the writing is not very elegant. Also, using personal pronouns (‘I’ or ‘we’) does not make sense for such a report, so a lot of passive voice is used.

The generated report provides an illustration of how the results of the model can be reported, but is not a substitute for a careful examination of the results.


Viechtbauer, W. (2010). Conducting meta-analyses in R with the metafor package. Journal of Statistical Software, 36(3), 1–48.

See also

rma.uni for the function to fit models for which an analysis report can be generated.


### copy BCG vaccine data into 'dat'
dat <-

### calculate log risk ratios and corresponding sampling variances
dat <- escalc(measure="RR", ai=tpos, bi=tneg, ci=cpos, di=cneg, data=dat,
              slab=paste(author, ", ", year, sep=""))

### fit random-effects model
res <- rma(yi, vi, data=dat)

### generate report
#> Directory for generating the report is: /tmp/RtmpYVT4ng
#> Copying references.bib and apa.csl to report directory ...
#> Saving model object to report_res.rdata ...
#> Creating report_res.rmd file ...
#> Rendering report_res.rmd file ...
#> Generated /tmp/RtmpYVT4ng/report_res.html ...
#> Opening report ...