- design
The trial design. If no trial design is specified, a fixed sample size design is used.
In this case, Type I error rate alpha, Type II error rate beta, twoSidedPower,
and sided can be directly entered as argument where necessary.
- ...
Ensures that all arguments (starting from the "...") are to be named and
that a warning will be displayed if unknown arguments are passed.
- groups
The number of treatment groups (1 or 2), default is 2.
- normalApproximation
If FALSE, the sample size
for the case of one treatment group is calculated exactly using the binomial distribution,
default is TRUE.
- conservative
For the case of one treatment group and normalApproximation = FALSE, if
TRUE, the sample size is calculated such that for larger sample size
than the calculated, the power is larger than 1 - beta, for conservative = FALSE, the minimum
sample size, for which power exceeds 1 - beta is calculated, default is TRUE.
- riskRatio
If TRUE, the sample size for one-sided
testing of H0: pi1 / pi2 = thetaH0 is calculated, default is FALSE.
- thetaH0
The null hypothesis value,
default is 0 for general estimates, the normal case, and the binary case,
it is 1 for the survival case (testing the hazard ratio).
For non-inferiority designs, thetaH0 is the non-inferiority bound.
That is, in case of (one-sided) testing of
general estimates: a value on the scale of the supplied estimates can be specified.
means: a value != 0
(or a value != 1 for testing the mean ratio) can be specified.
rates: a value != 0
(or a value != 1 for testing the risk ratio pi1 / pi2) can be specified.
survival data: a bound for testing H0: hazard ratio = thetaH0 != 1 can be specified.
count data: a bound for testing H0: lambda1 / lambda2 = thetaH0 != 1 can be specified.
For testing a rate in one sample, a value thetaH0 in (0, 1) has to be specified for
defining the null hypothesis H0: pi = thetaH0.
- pi1
A numeric value or vector that represents the assumed probability in
the active treatment group if two treatment groups
are considered, or the alternative probability for a one treatment group design,
default is seq(0.2, 0.5, 0.1) (power calculations and simulations) or
seq(0.4, 0.6, 0.1) (sample size calculations).
- pi2
A numeric value that represents the assumed probability in the reference group if two treatment
groups are considered, default is 0.2.
- directionUpper
Logical. Specifies the direction of the alternative,
only applicable for one-sided testing; TRUE
means that larger values of the test statistics yield smaller p-values.
The default is TRUE for means, rates, and count data, and FALSE for survival data
(power calculations, simulations, and analyses).
In sample size calculations, the direction is derived from the specified alternative;
a specified directionUpper must agree with it.
- allocationRatioPlanned
The planned allocation ratio n1 / n2 for a two treatment groups
design, default is 1. If allocationRatioPlanned = 0 is entered,
the optimal allocation ratio yielding the smallest overall sample size is determined.