Step-by-Step rpact Tutorial

Getting started
The R package rpact has been developed to design sequential and adaptive experiments. Many of the functions of the R package are available in an online Shiny app. For more information about rpact, including a quick start guide and manual, visit the rpact website. This step by step vignette accompanies the manuscript “Group Sequential Designs: A Tutorial” by Lakens, Pahlke, & Wassmer (2021).
Author

Daniel Lakens Friedrich Pahlke Gernot Wassmer

Published

February 16, 2024

Exploring the user interface of the rpact Shiny app

The online shiny app for rpact is available at https://shiny.rpact.com. The default settings when the Shiny app is loaded is for a fixed sample design, which means that there is only one look at the data (kMax = 1). In other words, the default setting is not for a sequential design, but a traditional design where the data is analyzed once. Moving the slider for the “Maximum number of stages” would increase the number of looks in the design (you can select up to up to 10 looks).

Screenshot of the default settings in the design tab of the rpact Shiny app.

The rpact package focuses on Confirmatory Adaptive Clinical Trial Design and Analysis. In clinical trials, researchers mostly test directional predictions, and thus, the default setting is to perform a one-sided test. Outside of clinical trials, it might be less common to design studies testing a directional prediction, but it is often a good idea. In clinical trials, it is common to use a 0.025 significance level (or Type I error rate) for one-sided tests, as it is deemed preferable in regulatory settings to set the Type I error rate for one-sided tests at half the conventional Type I error used in two-sided tests. In other fields, such as psychology, researchers typically use a 0.05 significance level, regardless of whether they perform a one-sided or two-sided test. A default 0.2 Type II error rate (or power of 0.8) is common in many fields, and is thus the default setting for the Type II error rate in the Shiny app.

Remember that you always need to justify your error rates – the defaults are most often not optimal choices in any real-life design (and it might be especially useful to choose a higher power, if possible).

Type I error rate control in sequential designs

We can explore a group sequential design by moving the slider for the maximum number of stages to, say, kMax = 2. The option to choose a design appears above the slider in the form of three “Design” radio buttons (Group Sequential, Inverse Normal, and Fisher), which by default is set to a group sequential design – this is the type of designs we will focus on in this step by step tutorial. The other options are relevant for adaptive designs which we will not discuss here.

A new drop down menu has appeared below the box to choose a Type II error rate that asks you to specify the “Type of design”. This allows you to choose how you want to control the \(\alpha\) level across looks. By default the choice is an O’Brien-Fleming design. Set the “Type of Design” option to “Pocock (P)”. Note there is also a Pocock type \(\alpha\)-spending (asP) option – we will use that later.

Because most people in social sciences will probably have more experience with two-sided tests at an \(\alpha\) of 0.05, choose a two-sided test and an \(\alpha\) level of 0.05 choose those settings. The input window should now look like the example below:

Screenshot of the default settings in the design tab of the rpact Shiny app.

Click on the “Plot” tab. The first plot in the drop-down menu shows the boundaries at each look. The critical \(z\) score at each look it presented, as is a reference line at \(z = 1.96\) and \(z = -1.96\). These reference lines are the critical value for a two-sided test with a single look (i.e., a fixed design) with an \(\alpha\) of 5%. We see that the boundaries on the \(z\) scale have increased. This means we need to observe a more extreme \(z\) score at an analysis to reject \(H_0\). Furthermore, we see that the critical bounds are constant across both looks. This is exactly the goal of the Pocock correction: The \(\alpha\) level is lowered so that the \(\alpha\) level is the same at each look, and the overall \(\alpha\) level across all looks at the data is controlled at 5%. It is conceptually very similar to the Bonferroni correction. We can reproduce the design and the plot in R using the following code:

design <- getDesignGroupSequential(
    kMax = 2,
    typeOfDesign = "P",
    alpha = 0.05,
    sided = 2
)

plot(design, type = 1)

In the drop-down menu, we can easily change the type of design from “Pocock (P)” to “O’Brien-Fleming (OF)” to see the effect of using different corrections for the critical values across looks in the plot. We see that the O’Brien-Fleming correction has a different goal. The critical value at the first look is very high (which also means the \(\alpha\) level for this look is very low), but the critical value at the final look is extremely close to the unadjusted critical value of 1.96 (or the \(\alpha\) level of 0.05).

design <- getDesignGroupSequential(
    kMax = 2,
    typeOfDesign = "OF",
    alpha = 0.05,
    sided = 2
)

plot(design, type = 1)

We can plot the corrections for different types of designs for each of 3 looks (2 interim looks and one final look) in the same plot in R. The plot below shows the Pocock, O’Brien-Fleming, Haybittle-Peto, and Wang-Tsiatis correction with \(\Delta\) = 0.25. We see that researchers can choose different approaches to spend their \(\alpha\)-level across looks. Researchers can choose to spend their \(\alpha\) conservatively (keeping most of the \(\alpha\) for the last look), or more liberally (spending more \(\alpha\) at the earlier looks, which increases the probability of stopping early for many true effect sizes).

# Comparison corrections
d1 <- getDesignGroupSequential(typeOfDesign = "OF", sided = 2, alpha = 0.05)
d2 <- getDesignGroupSequential(typeOfDesign = "P", sided = 2, alpha = 0.05)
d3 <- getDesignGroupSequential(
    typeOfDesign = "WT", deltaWT = 0.25,
    sided = 2, alpha = 0.05
)
d4 <- getDesignGroupSequential(typeOfDesign = "HP", sided = 2, alpha = 0.05)

designSet <- getDesignSet(designs = c(d1, d2, d3, d4), variedParameters = "typeOfDesign")

plot(designSet, type = 1, legendPosition = 5)

Because the statistical power of a test depends on the \(\alpha\) level (and the effect size and the sample size), this means that at the final look the statistical power of an O’Brien-Fleming or Haybittle-Peto design is very similar to the statistical power for a fixed design with only one look. If the \(\alpha\) is lowered, the sample size of a study needs to be increased to maintain the same statistical power at the last look. Therefore, the Pocock correction requires a remarkably larger increase in the maximum sample size than the O’Brien-Fleming or Haybittle-Peto correction. We will discuss these issues in more detail when we consider sample size planning below.

If you head to the “Report” tab, you can download an easily readable summary of the main results. Here, you can also see the \(\alpha\) level you would use for each look at the data (e.g., p < 0.0052, and p < 0.0480 for a O’Brien-Fleming type design with 2 looks).

Screenshot of the default settings in the design tab of the rpact Shiny app.

Corrected \(\alpha\) levels can be computed to many digits, but this quickly reaches a level of precision that is meaningless in real life. The observed type I error rate for all tests you will do in your lifetime is not noticeably different if you set the \(\alpha\) level at 0.0194, 0.019, or 0.02 (see the concept of ‘significant digits’. Even as we calculate and use \(\alpha\) thresholds up to many digits in sequential tests, the messiness of most research makes these \(\alpha\) levels have false precision. Keep this in mind when interpreting your data.

Note that the rpact Shiny app usefully shows the R code required to reproduce the output.

Screenshot of the R command required to reproduce the output.
design <- getDesignGroupSequential(
    typeOfDesign = "OF",
    informationRates = c(0.5, 1),
    alpha = 0.05,
    beta = 0.2,
    sided = 2
)

kable(summary(design))

Sequential analysis with a maximum of 2 looks (group sequential design)

O’Brien & Fleming design, two-sided overall significance level 5%, power 80%, undefined endpoint, inflation factor 1.0078, ASN H1 0.9022, ASN H01 0.9897, ASN H0 1.0052.

Stage 1 2
Information rate 50% 100%
Efficacy boundary (z-value scale) 2.797 1.977
Stage levels (one-sided) 0.0026 0.0240
Cumulative alpha spent 0.0052 0.0500
Overall power 0.2096 0.8000

Alpha spending functions

An important contribution to the sequential testing literature was made by Lan and DeMets (1983) who proposed the \(\alpha\)-spending function approach. In the figure below, the O’Brien-Fleming-like \(\alpha\)-spending function is plotted against the discrete O’Brien-Fleming bounds. We can see that the two approaches are not identical, but very comparable. The main benefit of these spending functions is that the error rate of the study can be controlled, while neither the number nor the timing of the looks needs to be specified in advance. This makes \(\alpha\)-spending approaches much more flexible. When using an \(\alpha\)-spending function it is important that the decision to perform an interim analysis is not based on collected data, as this can still can increase the Type I error rate.

d1 <- getDesignGroupSequential(typeOfDesign = "P", kMax = 5)
d2 <- getDesignGroupSequential(typeOfDesign = "asP", kMax = 5)
d3 <- getDesignGroupSequential(typeOfDesign = "OF", kMax = 5)
d4 <- getDesignGroupSequential(typeOfDesign = "asOF", kMax = 5)

designSet <- getDesignSet(
    designs = c(d1, d2, d3, d4),
    variedParameters = "typeOfDesign"
)
plot(designSet, type = 1)

Updating boundaries during a study

Although \(\alpha\)-spending functions control the Type I error rate even when there are deviations from the pre-planned number of looks, or their timing, this does require recalculating the boundaries used in the statistical test based on the amount of information that has been observed. Let us assume a researcher designs a study with three equally spaced looks at the data (two interim looks, one final look), using a Pocock-type spending function, where results will be analyzed in a two-sided t-test with an overall desired Type I error rate of 0.05, and a desired power of 0.9 for a Cohen’s d of 0.5. An a-priori power analysis (which we will explain later in this tutorial) shows that we achieve the desired power in our sequential design if we plan to look after 65.4, 130.9, and 196.3 observations in each condition. Since we cannot collect partial participants, we should round these numbers up, and because we have 2 independent groups, we will collect 66 observations for look 1 (33 in each condition), 132 at the second look (66 in each condition) and 198 at the third look (99 in each condition).

design <- getDesignGroupSequential(
    kMax = 3,
    typeOfDesign = "asP",
    sided = 2,
    alpha = 0.05,
    beta = 0.1
)

kable(summary(design))

Sequential analysis with a maximum of 3 looks (group sequential design)

Pocock type alpha spending design, two-sided overall significance level 5%, power 90%, undefined endpoint, inflation factor 1.1542, ASN H1 0.7212, ASN H01 1.0288, ASN H0 1.1308.

Stage 1 2 3
Information rate 33.3% 66.7% 100%
Efficacy boundary (z-value scale) 2.279 2.295 2.296
Stage levels (one-sided) 0.0113 0.0109 0.0108
Cumulative alpha spent 0.0226 0.0382 0.0500
Overall power 0.3940 0.7316 0.9000 
sampleSizeResult <- getSampleSizeMeans(
    design = design,
    groups = 2,
    alternative = 0.5,
    stDev = 1
)

kable(summary(sampleSizeResult))

Sample size calculation for a continuous endpoint

Sequential analysis with a maximum of 3 looks (group sequential design), overall significance level 5% (two-sided). The results were calculated for a two-sample t-test, H0: mu(1) - mu(2) = 0, H1: effect = 0.5, standard deviation = 1, power 90%.

Stage 1 2 3
Information rate 33.3% 66.7% 100%
Efficacy boundary (z-value scale) 2.279 2.295 2.296
Overall power 0.3940 0.7316 0.9000
Number of subjects 65.4 130.9 196.3
Expected number of subjects under H1 122.6
Cumulative alpha spent 0.0226 0.0382 0.0500
Two-sided local significance level 0.0226 0.0217 0.0217
Lower efficacy boundary (t) -0.578 -0.406 -0.330
Upper efficacy boundary (t) 0.578 0.406 0.330
Exit probability for efficacy (under H0) 0.0226 0.0155
Exit probability for efficacy (under H1) 0.3940 0.3375

Legend:

  • (t): treatment effect scale

Now imagine that due to logistical issues, we do not manage to analyze the data until we have collected data from 76 observations (38 in each condition) instead of the planned 66 observations. So our first look at the data does not occur at 33.3% of planned sample, but at 76/198 = 38.4% of the planned sample. We can recalculate the \(\alpha\) level we should use for each look at the data, based on the current look, and planned future looks. Instead of using the \(\alpha\)-levels 0.0226, 0.0217, and 0.0217 at the three respective looks (as indicated above in the summary of the originally planned design), we can adjust the information rates in the Shiny app (Double click on a cell to edit it; hit Ctrl+Enter to finish editing, or Esc to cancel):

Screenshot of the default information rates (above) and adapted information rates (below).

The updated \(\alpha\)-levels are 0.0253 for the current look, 0.0204 for the second look, and 0.0216 for the final look. To compute updated bounds in R directly, we can use the code:

design <- getDesignGroupSequential(
    typeOfDesign = "asP",
    informationRates = c(76 / 198, 2 / 3, 1),
    alpha = 0.05,
    sided = 2
)
kable(summary(design))

Sequential analysis with a maximum of 3 looks (group sequential design)

Pocock type alpha spending design, two-sided overall significance level 5%, power 80%, undefined endpoint, inflation factor 1.1697, ASN H1 0.8167, ASN H01 1.0686, ASN H0 1.1464.

Stage 1 2 3
Information rate 38.4% 66.7% 100%
Efficacy boundary (z-value scale) 2.236 2.318 2.296
Stage levels (one-sided) 0.0127 0.0102 0.0108
Cumulative alpha spent 0.0253 0.0382 0.0500
Overall power 0.3597 0.5999 0.8000

It is also possible to correct the \(\alpha\)-level if the final look at the data changes, for example because you are not able to collect the intended sample size, or because due to unforeseen circumstances you collect more data than planned. If this happens, we can no longer use the \(\alpha\)-spending function we chose, and instead have to provide a user-defined \(\alpha\)-spending function by updating the timing and \(\alpha\)-spending function to reflect the data collection as it actually occurred up to the final look.

Assuming the second look in our earlier example occurred as originally planned, but the last look occurred at 206 participants instead of 198 we can compute an updated \(\alpha\)-level for the last look. Given the current total sample size, we need to recompute the \(\alpha\)-levels for the earlier looks, which now occurred at 72/206 = 0.369, 132/206 = 0.641, and for the last look at 206/206 = 1.

Because the first and second look occurred with the adjusted \(\alpha\)-levels we computed after the first adjustment (\(\alpha\)-levels of 0.0253 and 0.0204) we can look at the “Cumulative alpha spent” row and see how much of our Type I error rate we spent so far (0.0253 and 0.382). We also know we want to spend the remainder of our Type I error rate at the last look, for a total of 0.05.

Our actual \(\alpha\)-spending function is no longer captures by the Pocock spending function after collecting more data than planned, but instead, we have a user defined spending function. We can enter both the updated information rates and the final \(\alpha\)-spending function directly in the Shiny app by selecting the “User defined alpha spending (asUser)” option as “Type of design”:

Screenshot of a user defined alpha spending function.

The output shows the computed \(\alpha\)-level for this final look is 0.0210 instead of 0.0216. The difference is very small in this specific case, but might be larger depending on the situation. This example shows the flexibility of group designs when \(\alpha\)-spending functions are used. We can also perform these calculations in R directly:

design <- getDesignGroupSequential(
    typeOfDesign = "asUser",
    informationRates =
        c(72 / 206, 132 / 206, 1),
    alpha = 0.05,
    sided = 2, userAlphaSpending = c(0.0253, 0.0382, 0.05)
)
kable(summary(design))

Sequential analysis with a maximum of 3 looks (group sequential design)

User defined alpha spending design (0.025, 0.038, 0.05), two-sided overall significance level 5%, power 80%, undefined endpoint, inflation factor 1.1833, ASN H1 0.8213, ASN H01 1.0795, ASN H0 1.1583.

Stage 1 2 3
Information rate 35% 64.1% 100%
Efficacy boundary (z-value scale) 2.237 2.329 2.312
Stage levels (one-sided) 0.0127 0.0099 0.0104
Cumulative alpha spent 0.0253 0.0382 0.0500
Overall power 0.3317 0.5826 0.8000

Power analysis for group sequential designs

We will once again start with the default settings of the Shiny app which is for a fixed design with one look. Click on the “Endpoint” tab to choose how you want to specify the desired endpoint in this study. We will assume we plan to perform a \(t\) test, and therefore, that our endpoint is based on the means we observe.

Screenshot of a user defined alpha spending function.

Then click the “Trial Settings” tab. Here, you can specify if you want to calculate the required sample size (to achieve a desired power) or compute the expected power (based on a chosen sample size). By default, the calculation will be for a two-group (independent) \(t\) test.

The same number of individuals are collected in each group (allocation ratio = 1). It is possible to choose to use a normal approximation (which some software programs use) but the default settings where the calculations are based on the \(t\) distribution, will be (ever so slightly) more accurate.

The effect under the null hypothesis \(H_0\) is 0 by default, the default effect under the alternative is 0.2, and the default standard deviation is 1. This means that by default the power analysis is for a standardized effect size of Cohen’s d = 0.2/1 = 0.2. That is a small effect. In this example we will assume a researcher is interested in detecting a somewhat more substantial effect size, a mean difference of 0.5. This can be specified by changing the effect under the alternative to 0.5. Note that it is possible to compute the power for multiple values by selecting a value larger than 1 in the “# values” drop-down menu (but we will calculate power for a single alternative for now).

We can also directly perform these calculations in R:

design <- getDesignGroupSequential(
    kMax = 1,
    alpha = 0.05,
    sided = 2
)

kable(summary(getSampleSizeMeans(design, alternative = 0.5)))

Sample size calculation for a continuous endpoint

Fixed sample analysis, significance level 5% (two-sided). The results were calculated for a two-sample t-test, H0: mu(1) - mu(2) = 0, H1: effect = 0.5, standard deviation = 1, power 80%.

Stage Fixed
Efficacy boundary (z-value scale) 1.960
Number of subjects 127.5
Two-sided local significance level 0.0500
Lower efficacy boundary (t) -0.350
Upper efficacy boundary (t) 0.350

Legend:

  • (t): treatment effect scale

Screenshot of the input for a two-group design with an expected effect size of d = 0.5.

Screenshot of the output of a power analysis for a fixed design.

These calculations show that for a fixed design we should collect 128 participants (64 in each condition) to achieve 80% power for a Cohen’s d of 0.5 (or a mean difference of 0.5 with an expected population standard deviation of 1).

This result is similar to what can be computed in power analysis software for non-sequential designs, such as G*power.

Screenshot of the output of a power analysis in G*Power.

Sample sizes and power across looks

We will now look at power in a sequential design. Change the slider for the number of looks (kMax) to 3. Furthermore, change the Type II error rate to 0.1 (a default of 0.2 is, regardless of what Cohen thought, really a bit large). By default rpact assumes we will look at the data at equal times – after 33%, 67%, and 100% of the data is collected. The default design is an O’Brien-Fleming design, with a one-sided test. Set the alternative hypothesis in the “Trial Settings” tab to 0.5. We can compute the sample size we would need for a sequential group design to achieve the desired error rates for a specified alternative using the getSampleSizeMeans() function in R.

seq_design_of <- getDesignGroupSequential(
    kMax = 3,
    typeOfDesign = "OF",
    sided = 1,
    alpha = 0.05,
    beta = 0.1
)

# Compute the sample size we need
power_res_of <- getSampleSizeMeans(
    design = seq_design_of,
    groups = 2,
    alternative = 0.5,
    stDev = 1,
    allocationRatioPlanned = 1,
    normalApproximation = FALSE
)

kable(summary(power_res_of))

Sample size calculation for a continuous endpoint

Sequential analysis with a maximum of 3 looks (group sequential design), overall significance level 5% (one-sided). The results were calculated for a two-sample t-test, H0: mu(1) - mu(2) = 0, H1: effect = 0.5, standard deviation = 1, power 90%.

Stage 1 2 3
Information rate 33.3% 66.7% 100%
Efficacy boundary (z-value scale) 2.961 2.094 1.710
Overall power 0.1055 0.6295 0.9000
Number of subjects 47.3 94.6 141.8
Expected number of subjects under H1 107.1
Cumulative alpha spent 0.0015 0.0187 0.0500
One-sided local significance level 0.0015 0.0181 0.0437
Efficacy boundary (t) 0.910 0.437 0.289
Exit probability for efficacy (under H0) 0.0015 0.0172
Exit probability for efficacy (under H1) 0.1055 0.5240

Legend:

  • (t): treatment effect scale

The same output is available in the Shiny app under the “Sample Size” tab.

Summary of power analysis for an O’Brien-Fleming design with 3 looks and a one-sided test with alpha = 0.05.

This output shows that at the first look, with a very strict \(\alpha\)-level of 0.0015, we will have almost no power. Even if there is a true effect of d = 0.5, in only 10.55% of the studies we run will we be able to stop after collecting 33% of the data has been collected (as we see in the row “Overall power” or “Cumulative Power”). One might wonder whether it would even be worth looking at the data at this time point (the answer might very well be ‘no’, and it is not necessary to design equally spaced looks). At the second look overall power is 62.95%, which gives us a reasonable chance to stop if there is an effect, at the the final look it should be 90%, as this is what we designed the study to achieve. We can also print the full results (instead of just a summary), or select “Details” in the Shiny app:

kable(power_res_of)

Design plan parameters and output for means

Design parameters

  • Information rates: 0.333, 0.667, 1.000
  • Critical values: 2.961, 2.094, 1.710
  • Futility bounds (binding): -Inf, -Inf
  • Cumulative alpha spending: 0.001533, 0.018739, 0.050000
  • Local one-sided significance levels: 0.001533, 0.018138, 0.043669
  • Significance level: 0.0500
  • Type II error rate: 0.1000
  • Test: one-sided

User defined parameters

  • Alternatives: 0.5

Default parameters

  • Mean ratio: FALSE
  • Theta H0: 0
  • Normal approximation: FALSE
  • Standard deviation: 1
  • Treatment groups: 2
  • Planned allocation ratio: 1

Sample size and output

  • Maximum number of subjects: 141.8
  • Maximum number of subjects (1): 70.9
  • Maximum number of subjects (2): 70.9
  • Number of subjects [1]: 47.3
  • Number of subjects [2]: 94.6
  • Number of subjects [3]: 141.8
  • Reject per stage [1]: 0.1055
  • Reject per stage [2]: 0.5240
  • Reject per stage [3]: 0.2705
  • Early stop: 0.6295
  • Expected number of subjects under H0: 140.9
  • Expected number of subjects under H0/H1: 132
  • Expected number of subjects under H1: 107.1
  • Critical values (treatment effect scale) [1]: 0.910
  • Critical values (treatment effect scale) [2]: 0.437
  • Critical values (treatment effect scale) [3]: 0.289

Legend

  • (i): values of treatment arm i
  • [k]: values at stage k

We see that the maximum number of subjects we would need to collect is 141.8, or rounded up, 142. The expected number of subjects under \(H_0\) (when there is no true effect) is 140.9 - we will almost always collect data up to the third look, unless we make a Type I error and stop at the first two looks.

The expected number of subjects under \(H_1\) (i.e., d = 0.5) is 107.1. If there is a true effect of d = 0.5, we will stop early in some studies, and therefore the average expected sample size is lower than the maximum.

We can plot the results across a range of possible effect sizes:

sample_res_plot <- getPowerMeans(
    design = seq_design_of,
    groups = 2,
    alternative = seq(0, 1, 0.01),
    stDev = 1,
    allocationRatioPlanned = 1,
    maxNumberOfSubjects = 142, # rounded up
    normalApproximation = FALSE
)

# code for plot (not run, we show an annotated version of this plot)
# plot(sample_res_plot, type = 6, legendPosition = 6)

Plot of power and average expected sample size for an O’Brien-Fleming design with 3 looks.

To create this plot in the Shiny app, you need to specify the design, in the endpoint tab select “Means”, and in the trial settings select “Power” as the calculation target, two groups, and for the number of values, select 50 from the drop-down menu. Specify the lower (i.e., 0) and upper (i.e., 1) value of the mean difference (given the standard deviation of 1, these values will also be Cohen’s d effect sizes). The maximum number of subjects is set to 142 (based on the power analysis we performed above). Go to the “Plot” tab and select the “Sample Size [6]” plot.

Screenshot of power and average expected sample size for an O’Brien-Fleming design with 3 looks in the Shiny app.

If you click on the “Plot” tab and select the Sample Size graph [6], and set the max sample size (nMax) to 50, you see that depending on the true effect size, there is a decent probability of stopping early (blue line) compared to at the final look (green line). Furthermore, the larger the effect size, the lower the Average sample size will be (red line).

Without sequential analyses we would collect 50 participants (the maximum sample size specified). But when the true effect size is large, we have a high probability to stop early, and the sample size that one needs to collect will on average (in the long run of doing many sequential designs) be lower.

After this general introduction to the benefits of group sequential designs to efficiently design well powered studies, we will look at more concrete examples of how to perform an a-priori power analysis for sequential designs.

A-priori power analysis in sequential designs

When designing a study where the goal is to test whether a specific effect can be statistically rejected researchers often want to make sure their sample size is large enough to have sufficient power for an effect size of interest. This is done by performing an a-priori power analysis. Given a specified effect size, \(\alpha\)-level, and desired power, an a-priori power analysis will indicate the number of observations that should be collected.

An informative study has a high probability of correctly concluding an effect is present when it is present, and absent when it is absent. An a-priori power analysis is used to choose a sample size to achieve desired Type I and Type II error rates, in the long run, given assumptions about the null and alternative model.

We will assume that we want to design a study that can detect a difference of 0.5, with an assumed standard deviation in the population of 1, which means the expected effect is a Cohen’s d of 0.5. If we plan to analyze our hypothesis in a one-sided \(t\) test (given our directional prediction), set the overall \(\alpha\)-level to 0.05, and want to achieve a Type II error probability of 0.1 (or a power of 0.9). Finally, we believe it is feasible to perform 2 interim analyses, and one final analysis (e.g., collect the data across three weeks, and we are willing to stop the data collection after any Friday). How many observations would we need?

The decision depends on the final factor we need to decide in a sequential design: the \(\alpha\)-spending function. We can choose an \(\alpha\)-spending function as we design our experiment, and compare different choices of a spending function. We will start by examining the sample size we need to collect if we choose an O’Brien-Fleming \(\alpha\)-spending function.

On the “Endpoint” tab we specify means. Then we move to the “Trial Design” tab. It is easy in rpact to plot power across a range of effect sizes, by selecting multiple values from the drop-down menu (i.e., 5). We set 0.3 and 0.7 as the lower and upper value, and keep the standard deviation at 1, so that we get the sample sizes for the range of Cohen’s d 0.3 to 0.7.

Sometimes you might have a clearly defined effect size to test against – such as a theoretically predicted effect size, or a smallest practically relevant effect size. Other times, you might primarily know the sample size you can achieve to collect, and you want to perform a sensitivity analysis, where you examine which effect size you can detect with a desired power, given a certain sample size. Plotting power across a range of effect sizes is typically useful. Even if you know which effect size you expect, you might want to look at what would be the consequences of the true effect size being slightly different than expected.

Screenshot of trial settings tab in the Shiny app where power is plotted for a range of 5 effect sizes under the alternative hypothesis ranging from 0.3 to 0.7.

Open the “Plot” tab and from the drop-down menu select “Sample size [6]”. You will see a plot like the one below, created with the R package. From the results (in the row “Maximum number of subjects”), we see that if the true effect size is indeed d = 0.5, we would need to collect at most 141 participants (the result differs very slightly from the power analysis reported above, as we use the O’Brien-Fleming alpha spending function, and not the O’Brien-Fleming correction). In the two rows below, we see that this is based on 71 (rounded up) participants in each condition, so in practice we would actually collect a total of 142 participants due to upward rounding within each condition.

design <- getDesignGroupSequential(
    typeOfDesign = "asOF",
    alpha = 0.05, beta = 0.1
)
sample_res <- (getSampleSizeMeans(design,
    alternative = c(0.3, 0.4, 0.5, 0.6, 0.7)
))
plot(sample_res, type = 5, legendPosition = 4)

This maximum is only slightly higher than if we had used a fixed design. For a fixed design (which you can examine by moving the slider for the maximum number of stages back to 1), we would need to collect 69.2 participants, or 138.4 in total, while for a sequential design, the maximum sample size per condition is 70.5.

The difference between a fixed design and a sequential design can be calculated by looking at the “Inflation factor”. We can find the inflation factor for the sequential design in the “Characteristics” in the “Design” tab (select for the R output “Details + characteristics”, or “Summary + details + characteristics”) which is 1.0187. In other words, the maximum sample size increased to 69.2 x 1.0187 = 70.5 per condition. The inflation is essentially caused by the reduction in the \(\alpha\)-level at the final look, and differs between designs (e.g., for a Pocock type alpha spending function, the inflation factor for the current design is larger, namely 1.1595)

However, the maximum sample size is not the expected sample size for this design, because of the possibility that we can stop data collection at an earlier look in the sequential design. In the long run, if d = 0.5, and we use an O’Brien-Fleming \(\alpha\)-spending function, and ignoring upward rounding because we can only collect a complete number of observations, we will sometimes collect 47 participants and stop after the first look see the row “Number of subjects [1]”), sometimes 94 and stop after the second look (see the row “Number of subjects [2]”)), and sometimes 141 and stop after the last look (see the row “Number of subjects [1]”)).

As we see in the row “Exit probability for efficacy (under H1)” we can stop early 6.75% of the time after look 1, 54.02% after look two, and in the remaining cases we will stop 1 - (0.0675 + 0.5402) = 39.23% of the time at the last look.

This means that, assuming there is a true effect of d = 0.5, the expected sample size on average is the probability of stopping at each look, multiplied by the number of observations we collect at each look, so 0.0675 * 47.0 + 0.5402 * 94.0 + ((1 - (0.0675 + 0.5402)) * 141.0) = 109.3, which matches the row “Expected number of subjects under H1” (again, assuming the alternative hypothesis of d = 0.5 is correct). So, in any single study we might need to collect slightly more data than in a fixed design, but on average we will need to collect less observations in a sequential design, namely 109.3, instead of 138.4 in a fixed design (assuming the alternative hypothesis is true).

design <- getDesignGroupSequential(typeOfDesign = "asOF", alpha = 0.05, beta = 0.1)
# getDesignCharacteristics(design)$inflationFactor
sample_res <- (getSampleSizeMeans(design, alternative = c(0.5)))
kable(sample_res)

Design plan parameters and output for means

Design parameters

  • Information rates: 0.333, 0.667, 1.000
  • Critical values: 3.200, 2.141, 1.695
  • Futility bounds (binding): -Inf, -Inf
  • Cumulative alpha spending: 0.0006869, 0.0163747, 0.0500000
  • Local one-sided significance levels: 0.0006869, 0.0161445, 0.0450555
  • Significance level: 0.0500
  • Type II error rate: 0.1000
  • Test: one-sided

User defined parameters

  • Alternatives: 0.5

Default parameters

  • Mean ratio: FALSE
  • Theta H0: 0
  • Normal approximation: FALSE
  • Standard deviation: 1
  • Treatment groups: 2
  • Planned allocation ratio: 1

Sample size and output

  • Maximum number of subjects: 141
  • Maximum number of subjects (1): 70.5
  • Maximum number of subjects (2): 70.5
  • Number of subjects [1]: 47
  • Number of subjects [2]: 94
  • Number of subjects [3]: 141
  • Reject per stage [1]: 0.06749
  • Reject per stage [2]: 0.54022
  • Reject per stage [3]: 0.29230
  • Early stop: 0.6077
  • Expected number of subjects under H0: 140.2
  • Expected number of subjects under H0/H1: 132.3
  • Expected number of subjects under H1: 109.3
  • Critical values (treatment effect scale) [1]: 0.995
  • Critical values (treatment effect scale) [2]: 0.448
  • Critical values (treatment effect scale) [3]: 0.287

Legend

  • (i): values of treatment arm i
  • [k]: values at stage k

For a Pocock \(\alpha\)-spending function the maximum sample size is larger (you can check by changing the spending function). The reason is that the \(\alpha\)-level at the final look is lower for a Pocock spending function than for the O’Brien-Fleming spending function, and the sample size required to achieve a desired power is thus higher. However, because the \(\alpha\)-level at the first look is higher, there is a higher probability of stopping early, and therefore the expected sample size is lower for a Pocock spending function (97.7 compared to 109.3). It is up to the researcher to choose a spending function, and weigh how desirable it would be to stop early, given some risk in any single study of increasing the sample size at the final look. For these specific design parameters, the Pocock \(\alpha\)-spending function might be more efficient on average, but also more risky in any single study.

Stopping for futility

So far, the sequential design would only stop at an interim analysis if we can reject \(H_0\). It is also possible to stop for futility, for example, based on a \(\beta\)-spending function. We can directly compare the previous design with a design where we stop for futility. Just as we are willing to distribute our Type I error rate across interim analyses, we can distribute our Type II error rate across looks, and decide to stop for futility when we can reject the presence of an effect at least as large as 0.5, even if we are then making a Type II error.

If there actually is no effect, such designs are more efficient. One can choose in advance to stop data collection when the presence of the effect the study was designed to detect can be rejected (i.e., binding \(\beta\)-spending), but it is typically recommended to allow the possibility to continue data collection (i.e., non-binding beta-spending). Adding futility bounds based on \(\beta\)-spending functions reduce power, and increase the required sample size to reach a desired power, but this is on average compensated by the fact that studies stop earlier due to futility, which can make designs more efficient.

Screenshot of the rpact input for an beta-spending function.

When an \(\alpha\)-spending function is chosen in the rpact Shiny app, a new drop-drown menu appears that allows users to choose a beta-spending function. In the R package, we simply add typeBetaSpending = "bsOF" to the specification of the design. You do not need to choose the same spending approach for \(\alpha\) and \(\beta\) as is done in this example.

design <- getDesignGroupSequential(
    typeOfDesign = "asOF",
    alpha = 0.05, beta = 0.1, typeBetaSpending = "bsOF"
)
sample_res <- (getSampleSizeMeans(design, alternative = 0.5))
kable(sample_res)

Design plan parameters and output for means

Design parameters

  • Information rates: 0.333, 0.667, 1.000
  • Critical values: 3.200, 2.141, 1.695
  • Futility bounds (binding): -0.873, 0.751
  • Cumulative alpha spending: 0.0006869, 0.0163747, 0.0500000
  • Local one-sided significance levels: 0.0006869, 0.0161445, 0.0450555
  • Significance level: 0.0500
  • Type II error rate: 0.1000
  • Test: one-sided

User defined parameters

  • Alternatives: 0.5

Default parameters

  • Mean ratio: FALSE
  • Theta H0: 0
  • Normal approximation: FALSE
  • Standard deviation: 1
  • Treatment groups: 2
  • Planned allocation ratio: 1

Sample size and output

  • Maximum number of subjects: 148.2
  • Maximum number of subjects (1): 74.1
  • Maximum number of subjects (2): 74.1
  • Number of subjects [1]: 49.4
  • Number of subjects [2]: 98.8
  • Number of subjects [3]: 148.2
  • Reject per stage [1]: 0.07327
  • Reject per stage [2]: 0.55751
  • Reject per stage [3]: 0.26921
  • Overall futility stop: 0.04395
  • Futility stop per stage [1]: 0.004386
  • Futility stop per stage [2]: 0.039568
  • Early stop: 0.6747
  • Expected number of subjects under H0: 99.6
  • Expected number of subjects under H0/H1: 121
  • Expected number of subjects under H1: 111
  • Critical values (treatment effect scale) [1]: 0.968
  • Critical values (treatment effect scale) [2]: 0.437
  • Critical values (treatment effect scale) [3]: 0.280
  • Futility bounds (treatment effect scale) [1]: -0.251
  • Futility bounds (treatment effect scale) [2]: 0.152
  • Futility bounds (one-sided p-value scale) [1]: 0.8085
  • Futility bounds (one-sided p-value scale) [2]: 0.2264

Legend

  • (i): values of treatment arm i
  • [k]: values at stage k

We see that with a \(\beta\)-spending function the Expected number of subjects under \(H_1\) has increased from 109.3 to 111.0. The maximum number of subjects has increased from 141 to 148.2. So, if the alternative hypothesis is true, stopping for futility comes at a cost. However, it is possible that \(H_0\) is true.

At the last look in our sequential design, which we designed to have 90% power, we are willing to act as if \(H_0\) is true with a 10% error rate. We can reverse the null and alternative hypothesis, and view the same decision process as an equivalence test. In this view, we test whether we can reject the presence of a meaningful effect. For example, if our smallest effect size of interest is a mean difference of 0.5, and we observe a mean difference that is surprisingly far away from 0.5, we can reject the presence of an effect that is large enough to care about. In essence, in such an equivalence test the Type II error of the original null hypothesis significance test has now become the Type I error rate. Because we have designed our null hypothesis significance test to have 90% power for a mean difference of 0.5, 10% of the time we would incorrectly decide to act as if an effect of at least 0.5 is absent. This is statistically comparable to performing an equivalence test with an \(\alpha\)-level of 10%, and decide to act as if we can reject the presence of an effect at least as large as 0.5, which should also happen 10% of the time, in the long run.

If we can reject the presence of a meaningful effect, whenever \(H_0\) is true, at an earlier look, we would save resources when \(H_0\) is true. We see that the expected number of subjects under \(H_0\) was 140.2. In other words, when \(H_0\) is true, we would continue to the last look most of the time (unless we made a Type 1 error at look 1 or 2). With a \(\beta\)-spending function, the expected number of subjects under \(H_0\) has decreased substantially, to 99.6. The choice of whether you want to use a \(\beta\)-spending function depends on the goals of your study. If you believe there is a decent probability \(H_0\) is true, and you would like to efficiently conclude this from the data, the use of a \(\beta\)-spending approach might be worth considering.

Reporting the results of a sequential analysis

A challenge when wanting to interpret the observed effect size is that whenever a study is stopped early when rejecting \(H_0\), there is a risk that we stopped because due to random variation we happened to observe a large effect size at the time of the interim analysis. This which means that the observed effect size at these interim analyses over-estimates the true effect.

A similar issue is at play when reporting \(p\) values and confidence intervals. When a sequential design is used, the distribution of a \(p\) value that does not account for the sequential nature of the design is no longer uniform when \(H_0\) is true. A \(p\) value is the probability of observing a result at least as extreme as the result that was observed, given that \(H_0\) is true. It is no longer straightforward to determine what ‘at least as extreme’ means a sequential design (Cook, 2002). It is possible to compute adjusted effect size estimates, confidence intervals, and \(p\) values in rpact. This currently cannot be done in the Shiny app.

Warning: 'thetaH1' (0.5) will be ignored because 'nPlanned' is not defined
Warning: 'assumedStDev' (1) will be ignored because 'nPlanned' is not defined

Imagine we have performed a study planned to have at most 3 equally spaced looks at the data, where we perform a two-sided test with an \(\alpha\) of 0.05, and we use a Pocock type \(\alpha\)-spending function, and we observe mean differences between the two conditions of \(\Delta M = 0.59\), 95% CI \([0.04, 1.13]\), \(t(64) = 2.16\), \(p = 0.034\) at stage 1, \(\Delta M = 0.39\), 95% CI \([0.00, 0.78]\), \(t(130) = 1.98\), \(p = 0.049\) at stage 2, and \(\Delta M = 0.47\), 95% CI \([0.15, 0.79]\), \(t(196) = 2.92\), \(p = 0.004\) at the last look. Based on a Pocock-like \(\alpha\)-spending function with three equally spaced looks the \(\alpha\)-level at each look for a two-sided \(t\) test is 0.02264, 0.02174, and 0.02168. We can thus reject \(H_0\) after look 3. But we would also like to report an effect size, and adjusted \(p\) values and confidence intervals.

The first step is to create a dataset with the results at each look, consisting of the sample sizes, means, and standard deviations. Note that these are the sample sizes, means, and standard deviations only based on the data at each stage. In other words, we compute the means and standard deviations of later looks by excluding the data in earlier looks, so every mean and standard deviation in this example is based on 33 observations in each condition.

data_means <- getDataset(
    n1 = c(33, 33, 33),
    n2 = c(33, 33, 33),
    means1 = c(0.6067868, 0.2795294, 0.7132186),
    means2 = c(0.01976029, 0.08212538, 0.08982903),
    stDevs1 = c(1.135266, 1.35426, 1.013671),
    stDevs2 = c(1.068052, 0.9610714, 1.225192)
)

kable(summary(data_means))

Dataset of means

The dataset contains the sample sizes, means, and standard deviations of one treatment and one control group. The total number of looks is three; stage-wise and cumulative data are included.

Stage 1 1 2 2 3 3
Group 1 2 1 2 1 2
Stage-wise sample size 33 33 33 33 33 33
Cumulative sample size 33 33 66 66 99 99
Stage-wise mean 0.607 0.020 0.280 0.082 0.713 0.090
Cumulative mean 0.607 0.020 0.443 0.051 0.533 0.064
Stage-wise standard deviation 1.135 1.068 1.354 0.961 1.014 1.225
Cumulative standard deviation 1.135 1.068 1.251 1.009 1.179 1.079

We then take our design:

seq_design <- getDesignGroupSequential(
    kMax = 3,
    typeOfDesign = "asP",
    sided = 2,
    alpha = 0.05,
    beta = 0.1
)

and compute the results based on the data we entered:

res <- getAnalysisResults(
    seq_design,
    equalVariances = FALSE,
    dataInput = data_means,
    thetaH1 = 0.5,
    assumedStDev = 1
)
Warning: 'thetaH1' (0.5) will be ignored because 'nPlanned' is not defined
Warning: 'assumedStDev' (1) will be ignored because 'nPlanned' is not defined

We can then print a summary of the results:

kable(summary(res))

Analysis results for a continuous endpoint

Sequential analysis with 3 looks (group sequential design). The results were calculated using a two-sample t-test (two-sided, alpha = 0.05), unequal variances option. H0: mu(1) - mu(2) = 0 against H1: mu(1) - mu(2) != 0.

Stage 1 2 3
Fixed weight 0.333 0.667 1
Efficacy boundary (z-value scale) 2.279 2.295 2.296
Cumulative alpha spent 0.0226 0.0382 0.0500
Stage level 0.0113 0.0109 0.0108
Cumulative effect size 0.587 0.392 0.469
Cumulative (pooled) standard deviation 1.102 1.136 1.130
Overall test statistic 2.163 1.983 2.921
Overall p-value 0.0171 0.0248 0.0019
Test action continue continue reject
Conditional rejection probability 0.3411 0.2303
95% repeated confidence interval [-0.047; 1.221] [-0.067; 0.852] [0.097 ; 0.841]
Repeated p-value 0.0757 0.1067 0.0105
Final p-value 0.0393
Final confidence interval [0.022; 0.743]
Median unbiased estimate 0.403

The results show that the action after look 1 and 2 was to continue data collection, and that we could reject \(H_0\) at the third look. The unadjusted mean difference is provided in the row “Overall effect size” and at the final look this was 0.469. The adjusted mean difference is provided in the row “Median unbiased estimate” and is lower, and the adjusted confidence interval is in the row “Final confidence interval”, giving the result 0.403, 95% CI [0.022, 0.743].

The unadjusted \(p\) values for a one-sided tests are reported in the row “Overall p-value”. The actual \(p\) values for our two-sided test would be twice as large, so 0.0342596, 0.0495679, 0.0038994. The adjusted \(p\) value at the final look is provided in the row “Final p-value” and it is 0.03928.

Conditional power analysis

The probability of finding a significant result, given the data that have been observed up to an interim analysis, is called conditional power. This approach can be useful in adaptive designs - designs where the final sample sizes is updated based on an early look at the data. In blinded sample size recalculation no effect size is calculated at an earlier look, but other aspects of the design, such as the standard deviation, are updated. In an unblinded sample size recalculation, the effect size estimate at an early look is used to determine the final sample size.

Let us imagine that we perform a sequential design using a Pocock \(\alpha\)- and \(\beta\)-spending function:

seq_design <- getDesignGroupSequential(
    sided = 1,
    alpha = 0.05,
    beta = 0.1,
    typeOfDesign = "asP",
    typeBetaSpending = "bsP",
    bindingFutility = FALSE
)

We perform an a-priori power analysis based on a smallest effect size of interest of d = 0.38, which yields a maximum number of subjects of 330.

power_res <- getSampleSizeMeans(
    design = seq_design,
    groups = 2,
    alternative = 0.38,
    stDev = 1,
    allocationRatioPlanned = 1,
    normalApproximation = FALSE
)

kable(summary(power_res))

Sample size calculation for a continuous endpoint

Sequential analysis with a maximum of 3 looks (group sequential design), overall significance level 5% (one-sided). The results were calculated for a two-sample t-test, H0: mu(1) - mu(2) = 0, H1: effect = 0.38, standard deviation = 1, power 90%.

Stage 1 2 3
Information rate 33.3% 66.7% 100%
Efficacy boundary (z-value scale) 2.002 1.994 1.980
Futility boundary (z-value scale) 0.293 1.175
Overall power 0.4933 0.8045 0.9000
Number of subjects 109.8 219.6 329.4
Expected number of subjects under H1 173.5
Cumulative alpha spent 0.0226 0.0382 0.0500
Cumulative beta spent 0.0453 0.0763 0.1000
One-sided local significance level 0.0226 0.0231 0.0238
Efficacy boundary (t) 0.387 0.271 0.219
Futility boundary (t) 0.056 0.159
Overall exit probability (under H0) 0.6378 0.2888
Overall exit probability (under H1) 0.5386 0.3422
Exit probability for efficacy (under H0) 0.0226 0.0148
Exit probability for efficacy (under H1) 0.4933 0.3112
Exit probability for futility (under H0) 0.6152 0.2740
Exit probability for futility (under H1) 0.0453 0.0311

Legend:

  • (t): treatment effect scale

We first looked at the data after we collected 110 observations. At this time, we observed a mean difference of 0.1. Let us say we assume the population standard deviation is 1, and that we are willing to collect 330 observations in total, as this gave us 90% power for the effect we wanted to detect, a mean difference of 0.5. Given the effect sie we observed, which is smaller than our smallest effect size of interest, what is the probability we will find a significant effect if we continue? We create a dataset:

data_means <- getDataset(
    n1 = c(55),
    n2 = c(55),
    means1 = c(0.1), # for directional test, means 1 > means 2
    means2 = c(0),
    stDevs1 = c(1),
    stDevs2 = c(1)
)

and analyze the results:

stage_res <- getStageResults(seq_design,
    equalVariances = TRUE,
    dataInput = data_means
)

kable(stage_res)

Stage results of means

Default parameters

  • Stages: 1, 2, 3
  • Theta H0: 0
  • Direction: upper
  • Normal approximation: FALSE
  • Equal variances: TRUE

Output

  • Overall test statistics: 0.524, NA, NA
  • Overall p-values: 0.3005, NA, NA
  • Cumulative means (1): 0.1, NA, NA
  • Cumulative means (2): 0, NA, NA
  • Cumulative standard deviations (1): 1, NA, NA
  • Cumulative standard deviations (2): 1, NA, NA
  • Cumulative sample sizes (1): 55, NA, NA
  • Cumulative sample sizes (2): 55, NA, NA
  • Stage-wise test statistics: 0.524, NA, NA
  • Stage-wise p-values: 0.3005, NA, NA
  • Cumulative effect sizes: 0.1, NA, NA

Legend

  • (i): values of treatment arm i

We can now perform a conditional power analysis based on the data we have observed so far. An important question is which effect size should be entered. Irrespective of the effect size we expected when designing the study, we have observed an effect of d = 0.1, and the smallest effect size of interest was a d = 0.38. We can compute the power under the assumption that the true effect size is d = 0.1 and d = 0.38:

# Compute conditional power after the first look
con_power_1 <- getConditionalPower(
    design = seq_design,
    stageResults = stage_res,
    nPlanned = c(110, 110), # The sample size planned for the subsequent stages.
    thetaH1 = 0.1, # alternative effect
    assumedStDev = 1 # standard deviation
)

kable(con_power_1)

Conditional power results means

User defined parameters

  • Planned sample size: NA, 110, 110
  • Assumed effect under alternative: 0.1
  • Assumed standard deviation: 1

Default parameters

  • Planned allocation ratio: 1

Output

  • Conditional power: NA, 0.0382, 0.0904

If the true effect size is 0.1, the power is 0.09 at the final look. Under this assumption, there is little use in continuing the data collection. Under the assumption that the smallest effect size of interest would be true:

# Compute conditional power after the first look
con_power_2 <- getConditionalPower(
    design = seq_design,
    stageResults = stage_res,
    nPlanned = c(110, 110), # The sample size planned for the subsequent stages.
    thetaH1 = 0.38, # alternative effect
    assumedStDev = 1 # standard deviation
)

kable(con_power_2)

Conditional power results means

User defined parameters

  • Planned sample size: NA, 110, 110
  • Assumed effect under alternative: 0.38
  • Assumed standard deviation: 1

Default parameters

  • Planned allocation ratio: 1

Output

  • Conditional power: NA, 0.3805, 0.7126

Under the assumption that the smallest effect size of interest exists, there is a reasonable probability of still observing a significant result at the last look (71.26%).

Preregistration and downloading a report

Because of the flexibility in choosing the number of looks, and the \(\alpha\)-spending function, it is important to preregister your statistical analysis plan. Preregistration allows other researchers to evaluate the severity of a test – how likely were you to find an effect if it is there, and how likely were you to not find an effect if there was no effect. Flexibility in the data analysis increases the Type 1 error rate, or the probability of finding an effect if there actually isn’t any effect (i.e., a false positive), and preregistering your sequential analysis plan can reveal to future readers that you severely tested your prediction.

The use of sequential analyses gives researchers more flexibility. To make sure this flexibility is not abused, the planned experimental design should be preregistered. The easiest way to do this is by either adding the rpact R code, or when the Shiny app is used, to use the export function and store the planned design as a PDF, R Markdown, or R file.

Screenshot of the option in rpact to export a report of the design.