print.summary.meta: Print detailed meta-analysis results

In meta: General Package for Meta-Analysis

Print detailed meta-analysis results

Description

Print method for objects of class summary.meta.

Usage

## S3 method for class 'summary.meta'
print(
  x,
  sortvar,
  common = x$x$common,
  random = x$x$random,
  details = FALSE,
  ma = TRUE,
  overall = x$overall & ma,
  backtransf = x$backtransf,
  pscale = x$pscale,
  irscale = x$irscale,
  irunit = x$irunit,
  digits = gs("digits"),
  digits.se = gs("digits.se"),
  digits.stat = gs("digits.stat"),
  digits.pval = max(gs("digits.pval"), 2),
  digits.tau2 = gs("digits.tau2"),
  digits.tau = gs("digits.tau"),
  digits.Q = gs("digits.Q"),
  digits.df = gs("digits.df"),
  digits.pval.Q = max(gs("digits.pval.Q"), 2),
  digits.H = gs("digits.H"),
  digits.I2 = gs("digits.I2"),
  digits.prop = gs("digits.prop"),
  digits.weight = gs("digits.weight"),
  scientific.pval = gs("scientific.pval"),
  zero.pval = gs("zero.pval"),
  JAMA.pval = gs("JAMA.pval"),
  big.mark = gs("big.mark"),
  print.tau2 = gs("print.tau2"),
  print.tau2.ci = gs("print.tau2.ci"),
  print.tau = gs("print.tau"),
  print.tau.ci = gs("print.tau.ci"),
  print.Q = gs("print.Q"),
  print.I2 = gs("print.I2"),
  print.I2.ci = gs("print.I2.ci"),
  print.H = gs("print.H"),
  print.Rb = gs("print.Rb"),
  text.tau2 = gs("text.tau2"),
  text.tau = gs("text.tau"),
  text.I2 = gs("text.I2"),
  text.Rb = gs("text.Rb"),
  truncate,
  text.truncate = "*** Output truncated ***",
  details.methods = TRUE,
  warn.backtransf = FALSE,
  ...
)

Arguments

x	An object of class summary.meta
sortvar	An optional vector used to sort the individual studies (must be of same length as x$TE).
common	A logical indicating whether results of common effect meta-analysis should be printed.
random	A logical indicating whether results of random effects meta-analysis should be printed.
details	A logical indicating whether further details of individual studies should be printed.
ma	A logical indicating whether the summary results of the meta-analysis should be printed.
overall	A logical indicating whether overall summaries should be reported. This argument is useful in a meta-analysis with subgroups if overall results should not be reported.
backtransf	A logical indicating whether printed results should be back transformed. If backtransf = TRUE, results for sm = "OR" are printed as odds ratios rather than log odds ratios and results for sm = "ZCOR" are printed as correlations rather than Fisher's z transformed correlations, for example.
pscale	A numeric giving scaling factor for printing of single event probabilities or risk differences, i.e. if argument sm is equal to "PLOGIT", "PLN", "PRAW", "PAS", "PFT", or "RD".
irscale	A numeric defining a scaling factor for printing of single incidence rates or incidence rate differences, i.e. if argument sm is equal to "IR", "IRLN", "IRS", "IRFT", or "IRD".
irunit	A character specifying the time unit used to calculate rates, e.g. person-years.
digits	Minimal number of significant digits, see print.default.
digits.se	Minimal number of significant digits for standard deviations and standard errors, see print.default.
digits.stat	Minimal number of significant digits for z- or t-value of test for effect, see print.default.
digits.pval	Minimal number of significant digits for p-value of test of treatment effect, see print.default.
digits.tau2	Minimal number of significant digits for between-study variance, see print.default.
digits.tau	Minimal number of significant digits for square root of between-study variance, see print.default.
digits.Q	Minimal number of significant digits for heterogeneity statistic Q, see print.default.
digits.df	Minimal number of significant digits for degrees of freedom.
digits.pval.Q	Minimal number of significant digits for p-value of heterogeneity test, see print.default.
digits.H	Minimal number of significant digits for H statistic, see print.default.
digits.I2	Minimal number of significant digits for I-squared and Rb statistic, see print.default.
digits.prop	Minimal number of significant digits for proportions, see print.default.
digits.weight	Minimal number of significant digits for weights, see print.default.
scientific.pval	A logical specifying whether p-values should be printed in scientific notation, e.g., 1.2345e-01 instead of 0.12345.
zero.pval	A logical specifying whether p-values should be printed with a leading zero.
JAMA.pval	A logical specifying whether p-values for test of overall effect should be printed according to JAMA reporting standards.
big.mark	A character used as thousands separator.
print.tau2	A logical specifying whether between-study variance \tau^2 should be printed.
print.tau2.ci	A logical value indicating whether to print the confidence interval of \tau^2.
print.tau	A logical specifying whether \tau, the square root of the between-study variance \tau^2, should be printed.
print.tau.ci	A logical value indicating whether to print the confidence interval of \tau.
print.Q	A logical value indicating whether to print the results of the test of heterogeneity.
print.I2	A logical specifying whether heterogeneity statistic I^2 should be printed.
print.I2.ci	A logical specifying whether confidence interval for heterogeneity statistic I^2 should be printed.
print.H	A logical specifying whether heterogeneity statistic H should be printed.
print.Rb	A logical specifying whether heterogeneity statistic R_b should be printed.
text.tau2	Text printed to identify between-study variance \tau^2.
text.tau	Text printed to identify \tau, the square root of the between-study variance \tau^2.
text.I2	Text printed to identify heterogeneity statistic I^2.
text.Rb	Text printed to identify heterogeneity statistic R_b.
truncate	An optional vector used to truncate the printout of results for individual studies (must be a logical vector of same length as x$TE or contain numerical values).
text.truncate	A character string printed if study results were truncated from the printout.
details.methods	A logical specifying whether details on statistical methods should be printed.
warn.backtransf	Deprecated argument (ignored).
...	Additional arguments (passed on to print.meta called internally).

Details

Print method for objects of class summary.meta giving detailed information on the meta-analysis.

Argument pscale can be used to rescale single proportions or risk differences, e.g. pscale = 1000 means that proportions are expressed as events per 1000 observations. This is useful in situations with (very) low event probabilities.

Argument irscale can be used to rescale single rates or rate differences, e.g. irscale = 1000 means that rates are expressed as events per 1000 time units, e.g. person-years. This is useful in situations with (very) low rates. Argument irunit can be used to specify the time unit used in individual studies (default: "person-years"). This information is printed in summaries and forest plots if argument irscale is not equal to 1.

Author(s)

Guido Schwarzer [e-mail]

References

Cooper H & Hedges LV (1994), The Handbook of Research Synthesis. Newbury Park, CA: Russell Sage Foundation.

Crippa A, Khudyakov P, Wang M, Orsini N, Spiegelman D (2016), A new measure of between-studies heterogeneity in meta-analysis. Statistics in Medicine, 35, 3661–75.

Higgins JPT & Thompson SG (2002), Quantifying heterogeneity in a meta-analysis. Statistics in Medicine, 21, 1539–58.

See Also

summary.meta, update.meta, metabin, metacont, metagen

Examples

data(Fleiss1993cont)
m1 <- metacont(n.psyc, mean.psyc, sd.psyc, n.cont, mean.cont, sd.cont,
  data = Fleiss1993cont, sm = "SMD", studlab = paste(study, year))
sm1 <- summary(m1)
sm1

print(sm1, digits = 2)

## Not run: 
# Use unicode characters to print tau^2, tau, and I^2 
print(sm1,
  text.tau2 = "\u03c4\u00b2",
  text.tau = "\u03c4", text.I2 = "I\u00b2")

## End(Not run)

meta documentation built on Oct. 31, 2024, 5:07 p.m.