effectSizeReplicationSuccess: Computes the minimum relative effect size to achieve...

In florafauna/RStest: Design and Analysis of Replication Studies

Description

The minimum relative effect size (replication to original) to achieve replication success is computed based on the result of the original study and the corresponding variance ratio.

Usage

effectSizeReplicationSuccess(
  zo,
  c = 1,
  level = 0.025,
  alternative = c("one.sided", "two.sided"),
  type = c("golden", "nominal", "liberal", "controlled")
)

Arguments

zo	Numeric vector of z-values from original studies.
c	Numeric vector of variance ratios of the original and replication effect estimates. This is usually the ratio of the sample size of the replication study to the sample size of the original study.
level	Replication success level. Default is 0.025.
alternative	Specifies if the replication success level is "one.sided" (default) or "two.sided". If the replication success level is one-sided, then effect size calculations are based on a one-sided assessment of replication success in the direction of the original effect estimate.
type	Type of recalibration. Can be either "golden" (default), "nominal" (no recalibration), "liberal", or "controlled". "golden" ensures that for an original study just significant at the specified level, replication success is only possible for replication effect estimates larger than the original one. See levelSceptical for details about recalibration types.

Details

effectSizeReplicationSuccess is the vectorized version of .effectSizeReplicationSuccess_. Vectorize is used to vectorize the function.

Value

The minimum relative effect size to achieve replication success.

Author(s)

Leonhard Held, Charlotte Micheloud, Samuel Pawel, Florian Gerber

References

Held, L., Micheloud, C., Pawel, S. (2021). The assessment of replication success based on relative effect size. https://arxiv.org/abs/2009.07782

See Also

sampleSizeReplicationSuccess, levelSceptical

Examples

po <- c(0.001, 0.002, 0.01, 0.02, 0.025)
zo <- p2z(po, alternative = "one.sided")

effectSizeReplicationSuccess(zo = zo, c = 1, level = 0.025,
                             alternative = "one.sided", type = "golden")
                             
effectSizeReplicationSuccess(zo = zo, c = 10, level = 0.025,
                             alternative = "one.sided", type = "golden")
                             
effectSizeReplicationSuccess(zo = zo, c= 2, level = 0.025,
                             alternative = "one.sided", type = "nominal")
                             
effectSizeReplicationSuccess(zo = zo, c = 2, level = 0.05,
                             alternative = "two.sided", type = "nominal")

florafauna/RStest documentation built on Dec. 20, 2021, 8:44 a.m.