summary.umbrella: Synthesize information of an object of class "umbrella" in a...

View source: R/functions_summary.R

summary.umbrellaR Documentation

Synthesize information of an object of class “umbrella” in a dataframe

Description

Synthesize information of an object of class “umbrella” in a dataframe

Usage

## S3 method for class 'umbrella'
summary(object, digits = 3, het_max = FALSE, ...)

Arguments

object

an object of class “umbrella”

digits

an integer value specifying the number of decimal places for the rounding of numeric values. Default is 3.

het_max

a logical variable indicating whether additional information on heterogeneity should be printed (tau^2, Q-statistic estimate and p-value).

...

other arguments that can be passed to the function

Details

Summary method for objects of class “umbrella”.

Value

All main results of an object of class “umbrella” are synthesized in a dataframe, with the results of each factors stored in their own row. Depending on the classification used, the dataframe returned include certain information presented below:

Factor the name of the factor.
Class the class assigned during the stratification of evidence.
n_studies the number of independent studies included in the factor.
total_n the total number of participants included in the factor.
n_cases the number of cases included in the factor.
n_controls the number of controls included in the factor.
measure the measured used in the calculations.
value the value of the pooled effect size expressed in its original metric. Note that
if a factor includes only one study, its effect size is used as the pooled effect size.
value_CI the 95% confidence interval (CI) around the pooled effect size expressed
in its original metric. Note that if a factor includes only one study, its 95% CI is
used as the pooled 95% CI.
eG the value of the pooled effect size expressed in equivalent Hedges' g (eG).
eG_CI the 95% CI around the pooled effect size expressed in eG.
eOR the value of the pooled effect size expressed in equivalent Odds ratio (eOR).
eOR_CI the 95% CI around the pooled effect size expressed in eOR.
p_value the p-value of the pooled effect size.
I2 the inconsistency (I^2) value (calculated only if the number of studies in the
meta-analysis is equal or larger to 2).
PI_eG the 95% prediction interval (PI) expressed in eG (calculated only if the number
of studies in the meta-analysis is equal or larger to 3).
PI_eOR the 95% PI expressed in eOR (calculated only if the number of studies in the
meta-analysis is equal or larger to 3).
PI_sign whether the 95% PI includes the null value ("notnull" vs. "null").
egger_p the p-value of the Egger's test for publication bias (calculated only
if the number of studies in the meta-analysis is equal or larger to 3).
egger_sign whether the p-value of the Egger's test is < .05 ("sig." vs. "ns").
ESB_p the p-value of the test for excess of significance bias.
ESB_sign whether the p-value of the excess of significance test is < .05 ("sig." vs. "ns").
power_med the power to detect a SMD of 0.5 at an alpha of .05 based on the number of
cases and controls included in the meta-analysis (when IRR is used as effect size
measure, the number of cases and controls in this calculation is assumed to be equal to
half the total number of cases included in the meta-analysis).
power present only in the 'Personalized' classification.
- If the user did not use the 'power' criteria to stratify the evidence, this column
contains the power to detect a small effect size (SMD = 0.2), a moderate effect
size (SMD = 0.5) and a large effect size (SMD = 0.8) at an alpha of .05 based on
the number of cases and controls included in the meta-analysis.
- If the user used the 'power' criteria to stratify the evidence, this column contains
the power to detect the values entered by the user at an alpha of .05 based on the
number of cases and controls included in the meta-analysis.
JK_p the largest p-value obtained in the jackknife leave-one-out meta-analysis (calculated
only if the number of studies in the meta-analysis is equal or larger to 2)
JK_sign whether the largest p-value in the jackknife meta-analysis is < .05 ("sig." vs. "ns")
largest_CI_eG the 95% CI of the largest study expressed in eG
largest_CI_eOR the 95% CI of the largest study expressed in eOR
largest_sign whether the 95% CI of the largest study includes the null value ("notnull" vs.
"null")
rob the percentage of participants included in studies at low risk of bias (calculated
only if this information is indicated in the dataset)
amstar the AMSTAR score of the meta-analysis (calculated only if this information is
indicated in the dataset)

See Also

metaumbrella-package() for the formatting of well-formatted datasets
umbrella() for conducting calculations needed for an umbrella review
add.evidence() for stratifying evidence in an umbrella review

Examples

### generate a summary of the results of an umbrella object
summary(umbrella(df.SMD))

metaumbrella documentation built on Nov. 7, 2023, 1:06 a.m.