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

Description Usage Arguments Details Value Author(s) References See Also Examples

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

1
2
3
4
5
6
7
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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
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")

ReplicationSuccess documentation built on July 16, 2021, 9:08 a.m.