sampleSizeReplicationSuccess {ReplicationSuccess} | R Documentation |
Computes the required relative sample size to achieve replication success with the sceptical p-value
Description
The relative sample size to achieve replication success is computed based on the z-value of the original study, the type of recalibration, the power and the design prior.
Usage
sampleSizeReplicationSuccess(
zo,
power = NA,
level = 0.025,
alternative = c("one.sided", "two.sided"),
type = c("golden", "nominal", "controlled"),
designPrior = c("conditional", "predictive", "EB"),
shrinkage = 0,
h = 0
)
Arguments
zo |
Numeric vector of z-values from original studies. |
power |
The power to achieve replication success. |
level |
Threshold for the calibrated sceptical p-value. Default is 0.025. |
alternative |
Specifies if |
type |
Type of recalibration. Can be either "golden" (default),
"nominal" (no recalibration), or "controlled". "golden" ensures that for
an original study just significant at the specified |
designPrior |
Is only taken into account when |
shrinkage |
Is only taken into account when |
h |
Is only taken into account when |
Details
sampleSizeReplicationSuccess
is the vectorized version of
the internal function .sampleSizeReplicationSuccess_
.
Vectorize
is used to vectorize the function.
Value
The relative sample size for replication success. If impossible to
achieve the desired power for specified inputs NaN
is returned.
Author(s)
Leonhard Held, Charlotte Micheloud, Samuel Pawel, Florian Gerber
References
Held, L. (2020). A new standard for the analysis and design of replication studies (with discussion). Journal of the Royal Statistical Society: Series A (Statistics in Society), 183, 431-448. doi:10.1111/rssa.12493
Held, L., Micheloud, C., Pawel, S. (2022). The assessment of replication success based on relative effect size. The Annals of Applied Statistics. 16:706-720. doi:10.1214/21-AOAS1502
Micheloud, C., Balabdaoui, F., Held, L. (2023). Assessing replicability with the sceptical p-value: Type-I error control and sample size planning. Statistica Neerlandica. doi:10.1111/stan.12312
See Also
pSceptical
, powerReplicationSuccess
,
levelSceptical
Examples
## based on power
sampleSizeReplicationSuccess(zo = p2z(0.0025), power = 0.8, level = 0.025,
type = "golden")
sampleSizeReplicationSuccess(zo = p2z(0.0025), power = 0.8, level = 0.025,
type = "golden", designPrior = "predictive")