boot_compare_cor: Comparing Correlations between independent studies with...

View source: R/boot_compare_cor.R

boot_compare_corR Documentation

Comparing Correlations between independent studies with bootstrapping

Description

[Stable]

A function to compare standardized mean differences (SMDs) between studies. This function is intended to be used to compare the compatibility of original studies with replication studies (lower p-values indicating lower compatibility).

Usage

boot_compare_cor(
  x1,
  y1,
  x2,
  y2,
  alternative = c("two.sided", "less", "greater", "equivalence", "minimal.effect"),
  method = c("pearson", "kendall", "spearman", "winsorized", "bendpercent"),
  alpha = 0.05,
  null = 0,
  R = 1999,
  ...
)

Arguments

x1, y1

numeric vectors of data values. x and y must have the same length from study 1.

x2, y2

numeric vectors of data values. x and y must have the same length from study 2.

alternative

a character string specifying the alternative hypothesis, must be one of "two.sided" (default), "greater", "less", "equivalence" (TOST), or "minimal.effect" (TOST). You can specify just the initial letter.

method

a character string indicating which correlation coefficient is to be used for the test. One of "winsorized", "bendpercent","pearson", "kendall", or "spearman", can be abbreviated.

alpha

alpha level (default = 0.05)

null

a number indicating the null hypothesis. Default is a correlation of zero.

R

number of bootstrap replicates

...

further arguments to be passed to or from methods.

Value

A list with class "htest" containing the following components:

  • "p.value": numeric scalar containing the p-value for the test under the null hypothesis.

  • "estimate": difference in correlations between studies.

  • "conf.int": percentile (bootstrap) confidence interval for difference in correlations.

  • "null.value": the specified hypothesized value for the null hypothesis.

  • "alternative": character string indicating the alternative hypothesis (the value of the input argument alternative). Possible values are "greater", "less", or "two-sided".

  • "method": a character string indicating how the association was measured.

  • "data.name": Names of input values.

  • "boot_res": List of bootstrapped results.

  • "call": the matched call.

See Also

Other compare studies: boot_compare_smd(), compare_cor(), compare_smd()


Lakens/TOSTER documentation built on April 17, 2024, 6:42 p.m.