funnel: Funnel plot.

View source: R/funnel.R

funnelR Documentation

Funnel plot.

Description

Takes a meta4diag object produced by the function meta4diag() and draws a funnel plot.

Usage

  ## S3 method for class 'meta4diag'
funnel(x, est.type="median",intervals=c(0.025,0.975), 
  lwd=1, arrow.lty=1,col="black",
  main="Funnel Plot", xlim, ylim, ...)

Arguments

x

A meta4diag object obtained by running the main function meta4diag().

est.type

The type of estimation of study specified summary points. Options are "mean" and "median".

intervals

A numerical vector with length 2 specifying the credible intervals that is of interst. The values should be taken from the argument quantiles (see meta4diag). The first value should be smaller than 0.5 and the second value should be larger than 0.5.

arrow.lty

Arrow line style.

lwd

Line width.

col

Color of cross.

main

An overall title for the plot.

xlim

A numeric value, giving the x coordinates ranges.

ylim

A numeric value, giving the y coordinates ranges.

...

Arguments to be passed to methods.

Details

A funnel plot is a graphical representation of a meta-analysis. Funnel plots are used primarily as a visual aid for detecting bias or heterogeneity, and often it is not possible to distinguish between the two. A complete collection of unbiased studies, all estimating the same underlying effect with different levels of precision, would produce a symmetric funnel shape, with increasing scatter with decreasing precision. An asymmetric funnel indicates a relationship between effect size and precision in the studies at hand. This is most likely to be due to reporting bias, to a systematic difference between smaller and larger studies, or to the presence of subsets of studies with different mean effect sizes.

The function funnel() gives the user flexibility to control the plots.

Value

Besides plotting, the function returns an invisible NULL.

Author(s)

Jingyi Guo and Andrea Riebler

References

Anzures-Cabrera J and Higgins J (2010). Graphical displays for meta-analysis: An overview with suggestions for practice. Research Synthesis Methods, 1, 66-80.

Examples

  ## Not run: 
    if(requireNamespace("INLA", quietly = TRUE)){
      require("INLA", quietly = TRUE)
      data(Catheter)
      res <- meta4diag(data = Catheter)
      funnel(res, est.type = "median")
    }
  
## End(Not run)

meta4diag documentation built on Nov. 29, 2023, 3:01 a.m.