Learn R Programming

rpact (version 2.0.6)

getConditionalPower: Get Conditional Power

Description

Calculates and returns the conditional power.

Usage

getConditionalPower(design, stageResults, ..., nPlanned)

Arguments

design

The trial design.

stageResults

The results at given stage, obtained from getStageResults.

nPlanned

The sample size planned for the subsequent stages. It should be a vector with length equal to the remaining stages and is the overall sample size in the two treatment groups if two groups are considered.

stage

The stage number (optional). Default: total number of existing stages in the data input.

allocationRatioPlanned

The allocation ratio for two treatment groups planned for the subsequent stages, the default value is 1.

thetaH1

or pi1, pi2 Assumed effect sizes or assumed rates pi1 to calculate the conditional power. Depending on the type of dataset, either thetaH1 (means and survival) or pi1, pi2 (rates) needs to be specified. Additionally, if testing means is specified, an assumed standard (assumedStDev) deviation can be specified, default is 1.

iterations

Iterations for simulating the power for Fisher's combination test. If the power for more than one remaining stages is to be determined for Fisher's combination test, it is estimated via simulation with specified iterations, the default value is 10000.

seed

Seed for simulating the power for Fisher's combination test. See above, default is a random seed.

Details

The conditional power is calculated only if effect size and sample size is specified.

For Fisher's combination test, the conditional power for more than one remaining stages is estimated via simulation.

See Also

plot.StageResults or plot.AnalysisResults for plotting the conditional power.