DST01

Patient Disposition

---

Output

Standard Table

Preview

lyt <- basic_table(show_colcounts = TRUE) %>%
  split_cols_by(
    "ACTARM",
    split_fun = add_overall_level("All Patients", first = FALSE)
  ) %>%
  count_occurrences(
    "EOSSTT",
    show_labels = "hidden"
  ) %>%
  analyze_vars(
    "DCSREAS",
    .stats = "count_fraction",
    denom = "N_col",
    show_labels = "hidden",
    .indent_mods = c(count_fraction = 1L)
  )

result1 <- build_table(lyt = lyt, df = adsl)
result1

                                  A: Drug X    B: Placebo   C: Combination   All Patients
                                   (N=134)      (N=134)        (N=132)         (N=400)   
—————————————————————————————————————————————————————————————————————————————————————————
COMPLETED                         68 (50.7%)   66 (49.3%)     73 (55.3%)     207 (51.7%) 
ONGOING                           24 (17.9%)   28 (20.9%)     21 (15.9%)      73 (18.2%) 
DISCONTINUED                      42 (31.3%)   40 (29.9%)     38 (28.8%)     120 (30.0%) 
  ADVERSE EVENT                    3 (2.2%)     6 (4.5%)       5 (3.8%)       14 (3.5%)  
  DEATH                           25 (18.7%)   23 (17.2%)     22 (16.7%)      70 (17.5%) 
  LACK OF EFFICACY                 2 (1.5%)     2 (1.5%)       3 (2.3%)        7 (1.8%)  
  PHYSICIAN DECISION               2 (1.5%)     3 (2.2%)       2 (1.5%)        7 (1.8%)  
  PROTOCOL VIOLATION               5 (3.7%)     3 (2.2%)        4 (3%)         12 (3%)   
  WITHDRAWAL BY PARENT/GUARDIAN     4 (3%)      2 (1.5%)       1 (0.8%)        7 (1.8%)  
  WITHDRAWAL BY SUBJECT            1 (0.7%)     1 (0.7%)       1 (0.8%)        3 (0.8%)  

Try this using WebR

Experimental use!

WebR is a tool allowing you to run R code in the web browser. Modify the code below and click run to see the results. Alternatively, copy the code and click here to open WebR in a new tab.

Table with Grouping of Reasons

Preview

lyt <- basic_table(show_colcounts = TRUE) %>%
  split_cols_by(
    "ACTARM",
    split_fun = add_overall_level("All Patients", first = FALSE)
  ) %>%
  count_occurrences(
    "EOSSTT",
    show_labels = "hidden"
  ) %>%
  split_rows_by("DCSREASGP", indent_mod = 1L) %>%
  analyze_vars(
    "DCSREAS",
    .stats = "count_fraction",
    denom = "N_col",
    show_labels = "hidden"
  )

tbl <- build_table(lyt = lyt, df = adsl_gp_added)
result2 <- prune_table(tbl) # remove rows containing all zeros

result2

                                    A: Drug X    B: Placebo   C: Combination   All Patients
                                     (N=134)      (N=134)        (N=132)         (N=400)   
———————————————————————————————————————————————————————————————————————————————————————————
COMPLETED                           68 (50.7%)   66 (49.3%)     73 (55.3%)     207 (51.7%) 
ONGOING                             24 (17.9%)   28 (20.9%)     21 (15.9%)      73 (18.2%) 
DISCONTINUED                        42 (31.3%)   40 (29.9%)     38 (28.8%)     120 (30.0%) 
  Safety                                                                                   
    ADVERSE EVENT                    3 (2.2%)     6 (4.5%)       5 (3.8%)       14 (3.5%)  
    DEATH                           25 (18.7%)   23 (17.2%)     22 (16.7%)      70 (17.5%) 
  Non-Safety                                                                               
    LACK OF EFFICACY                 2 (1.5%)     2 (1.5%)       3 (2.3%)        7 (1.8%)  
    PHYSICIAN DECISION               2 (1.5%)     3 (2.2%)       2 (1.5%)        7 (1.8%)  
    PROTOCOL VIOLATION               5 (3.7%)     3 (2.2%)        4 (3%)         12 (3%)   
    WITHDRAWAL BY PARENT/GUARDIAN     4 (3%)      2 (1.5%)       1 (0.8%)        7 (1.8%)  
    WITHDRAWAL BY SUBJECT            1 (0.7%)     1 (0.7%)       1 (0.8%)        3 (0.8%)  

Try this using WebR

Experimental use!

WebR is a tool allowing you to run R code in the web browser. Modify the code below and click run to see the results. Alternatively, copy the code and click here to open WebR in a new tab.

Table Adding Optional Rows

Preview

lyt <- basic_table(show_colcounts = TRUE) %>%
  split_cols_by(
    "ACTARM",
    split_fun = add_overall_level("All Patients", first = FALSE)
  ) %>%
  count_occurrences(
    "EOTSTT",
    show_labels = "hidden"
  )

tbl <- build_table(lyt = lyt, df = adsl_eotstt_added)
tbl <- prune_table(tbl) # remove rows containing all zeros

# Combine tables
col_info(result2) <- col_info(tbl)
result3 <- rbind(result2, tbl)

result3

                                    A: Drug X    B: Placebo   C: Combination   All Patients
                                     (N=134)      (N=134)        (N=132)         (N=400)   
———————————————————————————————————————————————————————————————————————————————————————————
COMPLETED                           68 (50.7%)   66 (49.3%)     73 (55.3%)     207 (51.7%) 
ONGOING                             24 (17.9%)   28 (20.9%)     21 (15.9%)      73 (18.2%) 
DISCONTINUED                        42 (31.3%)   40 (29.9%)     38 (28.8%)     120 (30.0%) 
  Safety                                                                                   
    ADVERSE EVENT                    3 (2.2%)     6 (4.5%)       5 (3.8%)       14 (3.5%)  
    DEATH                           25 (18.7%)   23 (17.2%)     22 (16.7%)      70 (17.5%) 
  Non-Safety                                                                               
    LACK OF EFFICACY                 2 (1.5%)     2 (1.5%)       3 (2.3%)        7 (1.8%)  
    PHYSICIAN DECISION               2 (1.5%)     3 (2.2%)       2 (1.5%)        7 (1.8%)  
    PROTOCOL VIOLATION               5 (3.7%)     3 (2.2%)        4 (3%)         12 (3%)   
    WITHDRAWAL BY PARENT/GUARDIAN     4 (3%)      2 (1.5%)       1 (0.8%)        7 (1.8%)  
    WITHDRAWAL BY SUBJECT            1 (0.7%)     1 (0.7%)       1 (0.8%)        3 (0.8%)  
COMPLETED                           46 (34.3%)   38 (28.4%)     41 (31.1%)     125 (31.2%) 
ONGOING                             50 (37.3%)   51 (38.1%)     46 (34.8%)     147 (36.8%) 
DISCONTINUED                        38 (28.4%)   45 (33.6%)     45 (34.1%)     128 (32.0%) 

Try this using WebR

Experimental use!

WebR is a tool allowing you to run R code in the web browser. Modify the code below and click run to see the results. Alternatively, copy the code and click here to open WebR in a new tab.

Data Setup

library(tern)
library(dplyr)

set.seed(1, kind = "Mersenne-Twister")
adsl <- random.cdisc.data::cadsl

# reorder EOSSTT factor levels so DISCONTINUED is the last level
adsl <- df_explicit_na(adsl) %>%
  mutate(EOSSTT = factor(EOSSTT, levels = c("COMPLETED", "ONGOING", "DISCONTINUED")))

adsl_gp_added <- adsl %>%
  mutate(DCSREASGP = case_when(
    DCSREAS %in% c("ADVERSE EVENT", "DEATH") ~ "Safety",
    (DCSREAS != "<Missing>" & !DCSREAS %in% c("ADVERSE EVENT", "DEATH")) ~ "Non-Safety",
    DCSREAS == "<Missing>" ~ "<Missing>"
  ) %>% factor(levels = c("Safety", "Non-Safety", "<Missing>")))

adsl_eotstt_added <- adsl_gp_added %>%
  mutate(
    EOTSTT = sample(
      c("ONGOING", "COMPLETED", "DISCONTINUED"),
      size = nrow(adsl),
      replace = TRUE
    ) %>% factor(levels = c("COMPLETED", "ONGOING", "DISCONTINUED"))
  )

teal App

Preview

library(teal.modules.clinical)

## Data reproducible code
data <- teal_data()
data <- within(data, {
  library(dplyr)

  set.seed(1, kind = "Mersenne-Twister")
  ADSL <- random.cdisc.data::cadsl
  ADSL <- df_explicit_na(ADSL)
  ADSL <- ADSL %>%
    mutate(
      DCSREASGP = case_when(
        DCSREAS %in% c("ADVERSE EVENT", "DEATH") ~ "Safety",
        (DCSREAS != "<Missing>" & !DCSREAS %in% c("ADVERSE EVENT", "DEATH")) ~ "Non-Safety",
        DCSREAS == "<Missing>" ~ "<Missing>"
      ) %>% as.factor(),
      EOTSTT = sample(
        c("ONGOING", "COMPLETED", "DISCONTINUED"),
        size = nrow(ADSL),
        replace = TRUE
      ) %>% as.factor()
    ) %>%
    col_relabel(
      EOTSTT = "End Of Treatment Status"
    )

  date_vars_asl <- names(ADSL)[vapply(ADSL, function(x) inherits(x, c("Date", "POSIXct", "POSIXlt")), logical(1))]
  demog_vars_asl <- names(ADSL)[!(names(ADSL) %in% c("USUBJID", "STUDYID", date_vars_asl))]
})
datanames <- "ADSL"
datanames(data) <- datanames

Warning: `datanames<-()` was deprecated in teal.data 0.7.0.
ℹ invalid to use `datanames()<-` or `names()<-` on an object of class
  `teal_data`. See ?names.teal_data

join_keys(data) <- default_cdisc_join_keys[datanames]

## Reusable Configuration For Modules
ADSL <- data[["ADSL"]]
demog_vars_asl <- data[["demog_vars_asl"]]

## Setup App
app <- init(
  data = data,
  modules = modules(
    tm_t_summary(
      label = "Disposition Table",
      dataname = "ADSL",
      arm_var = choices_selected(c("ARM", "ARMCD"), "ARM"),
      summarize_vars = choices_selected(
        variable_choices(ADSL, demog_vars_asl),
        c("EOSSTT", "DCSREAS", "EOTSTT")
      ),
      useNA = "ifany"
    )
  )
)

shinyApp(app$ui, app$server)

Try this using shinylive

Experimental use!

shinylive allow you to modify to run shiny application entirely in the web browser. Modify the code below and click re-run the app to see the results. The performance is slighly worse and some of the features (e.g. downloading) might not work at all.

#| '!! shinylive warning !!': |
#|   shinylive does not work in self-contained HTML documents.
#|   Please set `embed-resources: false` in your metadata.
#| standalone: true
#| viewerHeight: 800
#| editorHeight: 200
#| components: [viewer, editor]
#| layout: vertical

# -- WEBR HELPERS --
options(webr_pkg_repos = c("r-universe" = "https://insightsengineering.r-universe.dev", getOption("webr_pkg_repos")))

# -- APP CODE --
library(teal.modules.clinical)

## Data reproducible code
data <- teal_data()
data <- within(data, {
  library(dplyr)

  set.seed(1, kind = "Mersenne-Twister")
  ADSL <- random.cdisc.data::cadsl
  ADSL <- df_explicit_na(ADSL)
  ADSL <- ADSL %>%
    mutate(
      DCSREASGP = case_when(
        DCSREAS %in% c("ADVERSE EVENT", "DEATH") ~ "Safety",
        (DCSREAS != "<Missing>" & !DCSREAS %in% c("ADVERSE EVENT", "DEATH")) ~ "Non-Safety",
        DCSREAS == "<Missing>" ~ "<Missing>"
      ) %>% as.factor(),
      EOTSTT = sample(
        c("ONGOING", "COMPLETED", "DISCONTINUED"),
        size = nrow(ADSL),
        replace = TRUE
      ) %>% as.factor()
    ) %>%
    col_relabel(
      EOTSTT = "End Of Treatment Status"
    )

  date_vars_asl <- names(ADSL)[vapply(ADSL, function(x) inherits(x, c("Date", "POSIXct", "POSIXlt")), logical(1))]
  demog_vars_asl <- names(ADSL)[!(names(ADSL) %in% c("USUBJID", "STUDYID", date_vars_asl))]
})
datanames <- "ADSL"
datanames(data) <- datanames
join_keys(data) <- default_cdisc_join_keys[datanames]

## Reusable Configuration For Modules
ADSL <- data[["ADSL"]]
demog_vars_asl <- data[["demog_vars_asl"]]

## Setup App
app <- init(
  data = data,
  modules = modules(
    tm_t_summary(
      label = "Disposition Table",
      dataname = "ADSL",
      arm_var = choices_selected(c("ARM", "ARMCD"), "ARM"),
      summarize_vars = choices_selected(
        variable_choices(ADSL, demog_vars_asl),
        c("EOSSTT", "DCSREAS", "EOTSTT")
      ),
      useNA = "ifany"
    )
  )
)

shinyApp(app$ui, app$server)

Reproducibility

Timestamp

[1] "2025-07-09 17:38:48 UTC"

Session Info

─ Session info ───────────────────────────────────────────────────────────────
 setting  value
 version  R version 4.5.0 (2025-04-11)
 os       Ubuntu 24.04.2 LTS
 system   x86_64, linux-gnu
 ui       X11
 language (EN)
 collate  en_US.UTF-8
 ctype    en_US.UTF-8
 tz       Etc/UTC
 date     2025-07-09
 pandoc   3.7.0.2 @ /usr/bin/ (via rmarkdown)
 quarto   1.7.32 @ /usr/local/bin/quarto

─ Packages ───────────────────────────────────────────────────────────────────
 package               * version  date (UTC) lib source
 backports               1.5.0    2024-05-23 [1] RSPM
 brio                    1.1.5    2024-04-24 [1] RSPM
 broom                   1.0.8    2025-03-28 [1] RSPM
 bslib                   0.9.0    2025-01-30 [1] RSPM
 cachem                  1.1.0    2024-05-16 [1] RSPM
 callr                   3.7.6    2024-03-25 [1] RSPM
 checkmate               2.3.2    2024-07-29 [1] RSPM
 chromote                0.5.1    2025-04-24 [1] RSPM
 cli                     3.6.5    2025-04-23 [1] RSPM
 coda                    0.19-4.1 2024-01-31 [1] CRAN (R 4.5.0)
 codetools               0.2-20   2024-03-31 [2] CRAN (R 4.5.0)
 curl                    6.4.0    2025-06-22 [1] RSPM
 dichromat               2.0-0.1  2022-05-02 [1] CRAN (R 4.5.0)
 digest                  0.6.37   2024-08-19 [1] RSPM
 dplyr                 * 1.1.4    2023-11-17 [1] RSPM
 emmeans                 1.11.1   2025-05-04 [1] RSPM
 estimability            1.5.1    2024-05-12 [1] RSPM
 evaluate                1.0.4    2025-06-18 [1] RSPM
 farver                  2.1.2    2024-05-13 [1] RSPM
 fastmap                 1.2.0    2024-05-15 [1] RSPM
 fontawesome             0.5.3    2024-11-16 [1] RSPM
 forcats                 1.0.0    2023-01-29 [1] RSPM
 formatR                 1.14     2023-01-17 [1] CRAN (R 4.5.0)
 formatters            * 0.5.11   2025-04-09 [1] RSPM
 geepack                 1.3.12   2024-09-23 [1] RSPM
 generics                0.1.4    2025-05-09 [1] RSPM
 ggplot2                 3.5.2    2025-04-09 [1] RSPM
 glue                    1.8.0    2024-09-30 [1] RSPM
 gtable                  0.3.6    2024-10-25 [1] RSPM
 htmltools               0.5.8.1  2024-04-04 [1] RSPM
 htmlwidgets             1.6.4    2023-12-06 [1] RSPM
 httpuv                  1.6.16   2025-04-16 [1] RSPM
 jquerylib               0.1.4    2021-04-26 [1] RSPM
 jsonlite                2.0.0    2025-03-27 [1] RSPM
 knitr                   1.50     2025-03-16 [1] RSPM
 later                   1.4.2    2025-04-08 [1] RSPM
 lattice                 0.22-7   2025-04-02 [2] CRAN (R 4.5.0)
 lifecycle               1.0.4    2023-11-07 [1] RSPM
 logger                  0.4.0    2024-10-22 [1] RSPM
 magrittr              * 2.0.3    2022-03-30 [1] RSPM
 MASS                    7.3-65   2025-02-28 [2] CRAN (R 4.5.0)
 Matrix                  1.7-3    2025-03-11 [1] CRAN (R 4.5.0)
 memoise                 2.0.1    2021-11-26 [1] RSPM
 mime                    0.13     2025-03-17 [1] RSPM
 multcomp                1.4-28   2025-01-29 [1] RSPM
 mvtnorm                 1.3-3    2025-01-10 [1] RSPM
 nestcolor               0.1.3    2025-01-21 [1] RSPM
 nlme                    3.1-168  2025-03-31 [2] CRAN (R 4.5.0)
 pillar                  1.11.0   2025-07-04 [1] RSPM
 pkgcache                2.2.4    2025-05-26 [1] RSPM
 pkgconfig               2.0.3    2019-09-22 [1] RSPM
 processx                3.8.6    2025-02-21 [1] RSPM
 promises                1.3.3    2025-05-29 [1] RSPM
 ps                      1.9.1    2025-04-12 [1] RSPM
 purrr                   1.0.4    2025-02-05 [1] RSPM
 R6                      2.6.1    2025-02-15 [1] RSPM
 random.cdisc.data       0.3.16   2024-10-10 [1] RSPM
 rbibutils               2.3      2024-10-04 [1] RSPM
 RColorBrewer            1.1-3    2022-04-03 [1] RSPM
 Rcpp                    1.1.0    2025-07-02 [1] RSPM
 Rdpack                  2.6.4    2025-04-09 [1] RSPM
 rlang                   1.1.6    2025-04-11 [1] RSPM
 rmarkdown               2.29     2024-11-04 [1] RSPM
 rtables               * 0.6.13   2025-06-19 [1] RSPM
 sandwich                3.1-1    2024-09-15 [1] RSPM
 sass                    0.4.10   2025-04-11 [1] RSPM
 scales                  1.4.0    2025-04-24 [1] RSPM
 sessioninfo             1.2.3    2025-02-05 [1] any (@1.2.3)
 shiny                 * 1.11.1   2025-07-03 [1] RSPM
 shinycssloaders         1.1.0    2024-07-30 [1] RSPM
 shinyjs                 2.1.0    2021-12-23 [1] RSPM
 shinyvalidate           0.1.3    2023-10-04 [1] RSPM
 shinyWidgets            0.9.0    2025-02-21 [1] RSPM
 stringi                 1.8.7    2025-03-27 [1] RSPM
 stringr                 1.5.1    2023-11-14 [1] RSPM
 survival                3.8-3    2024-12-17 [2] CRAN (R 4.5.0)
 teal                  * 0.16.0   2025-02-23 [1] RSPM
 teal.code             * 0.6.1    2025-02-14 [1] RSPM
 teal.data             * 0.7.0    2025-01-28 [1] RSPM
 teal.logger             0.4.0    2025-07-08 [1] RSPM
 teal.modules.clinical * 0.10.0   2025-02-28 [1] RSPM
 teal.reporter           0.4.0    2025-01-24 [1] RSPM
 teal.slice            * 0.6.0    2025-02-03 [1] RSPM
 teal.transform        * 0.6.0    2025-02-12 [1] RSPM
 teal.widgets            0.4.3    2025-01-31 [1] RSPM
 tern                  * 0.9.9    2025-06-20 [1] RSPM
 tern.gee                0.1.5    2024-08-23 [1] RSPM
 testthat                3.2.3    2025-01-13 [1] RSPM
 TH.data                 1.1-3    2025-01-17 [1] RSPM
 tibble                  3.3.0    2025-06-08 [1] RSPM
 tidyr                   1.3.1    2024-01-24 [1] RSPM
 tidyselect              1.2.1    2024-03-11 [1] RSPM
 vctrs                   0.6.5    2023-12-01 [1] RSPM
 webshot                 0.5.5    2023-06-26 [1] CRAN (R 4.5.0)
 webshot2                0.1.2    2025-04-23 [1] RSPM
 websocket               1.4.4    2025-04-10 [1] RSPM
 withr                   3.0.2    2024-10-28 [1] RSPM
 xfun                    0.52     2025-04-02 [1] RSPM
 xtable                  1.8-4    2019-04-21 [1] RSPM
 yaml                    2.3.10   2024-07-26 [1] RSPM
 zoo                     1.8-14   2025-04-10 [1] RSPM

 [1] /usr/local/lib/R/site-library
 [2] /usr/local/lib/R/library
 [3] /github/home/R/x86_64-pc-linux-gnu-library/4.5
 * ── Packages attached to the search path.

──────────────────────────────────────────────────────────────────────────────

.lock file

Download the .lock file and use renv::restore() on it to recreate environment used to generate this website.

Download