DST01 Table 1 (Default) Patient Disposition Table 1.

The DST01 Disposition Table provides an overview of patients study completion. For patients who discontinued the study a reason is provided.

Usage

dst01_1_main(
  adam_db,
  arm_var = "ARM",
  status_var = "EOSSTT",
  disc_reason_var = "DCSREAS",
  lbl_overall = "All Patients",
  deco = std_deco("DST01"),
  ...
)

dst01_1_lyt(
  arm_var,
  status_var,
  disc_reason_var,
  completed_lbl,
  ongoing_lbl,
  discontinued_lbl,
  lbl_overall,
  deco
)

dst01_1_pre(adam_db, status_var = "EOSSTT", disc_reason_var = "DCSREAS", ...)

dst01_1_post(tlg, prune_0 = TRUE, deco = std_deco("DST01"), ...)

dst01_1

Format

An object of class chevron_t of length 1.

Arguments

adam_db: (dm) object containing the ADaM datasets
arm_var: (string) variable. Usually one of ARM, ACTARM, TRT01A, or TRT01A.
status_var: (string) variable used to define patient status. Default is EOSSTT, however can also be a variable name with the pattern EOPxxSTT where xx must be substituted by 2 digits referring to the analysis period.
disc_reason_var: (string) variable used to define reason for patient withdrawal. Default is DCSREAS, however can also be a variable with the pattern DCPxxRS where xx must be substituted by 2 digits referring to the analysis period.
lbl_overall: (string) label used for overall column, if set to NULL the overall column is omitted
deco: (character) decoration with title, subtitles and main_footer content
...: not used.
completed_lbl: (string) associated with completed study and found in the columns given by status. By Default COMPLETED.
ongoing_lbl: (string) associated with ongoing treatment and found in the columns given by status_treatment. By Default `ONGOING.
discontinued_lbl: (string) associated with discontinued study and found in the columns given by status. By Default DISCONTINUED.
tlg: (TableTree, Listing or ggplot) object typically produced by a main function.
prune_0: (flag) remove 0 count rows

Details

Default patient disposition table summarizing the reasons for patients withdrawal.
Numbers represent absolute numbers of patients and fraction of N.
Remove zero-count rows.
Split columns by arm.
Include a total column by default.
Sort withdrawal reasons by alphabetic order.

Since the two parts of the tables are pruned differently, the layout function returns a list of layouts, which allows the tables to be constructed and pruned separately before binding.

Functions

dst01_1_main(): Main TLG function
dst01_1_lyt(): Layout
dst01_1_pre(): Preprocessing
dst01_1_post(): Postprocessing

Note

adam_db object must contain an adsl table with the columns specified by status_var and disc_reason_var.

Examples

library(dm)
library(magrittr)

db <- syn_data %>%
  dst01_1_pre()

dst01_1_main(db)
#> [[1]]
#>                   A: Drug X    B: Placebo   C: Combination   All Patients
#>                    (N=134)      (N=134)        (N=132)         (N=400)   
#> —————————————————————————————————————————————————————————————————————————
#> Completed Study   68 (50.7%)   66 (49.3%)     73 (55.3%)     207 (51.7%) 
#> 
#> [[2]]
#>                                   A: Drug X    B: Placebo   C: Combination   All Patients
#>                                    (N=134)      (N=134)        (N=132)         (N=400)   
#> —————————————————————————————————————————————————————————————————————————————————————————
#> Ongoing                           24 (17.9%)   28 (20.9%)     21 (15.9%)      73 (18.2%) 
#> Discontinued Study                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.0%)       12 (3.0%)  
#>   WITHDRAWAL BY PARENT/GUARDIAN    4 (3.0%)     2 (1.5%)       1 (0.8%)        7 (1.8%)  
#>   WITHDRAWAL BY SUBJECT            1 (0.7%)     1 (0.7%)       1 (0.8%)        3 (0.8%)  
#> 
dst01_1_pre(syn_data)
#> ── Metadata ────────────────────────────────────────────────────────────────────
#> Tables: `adsl`, `adab`, `adae`, `adaette`, `adcm`, … (19 total)
#> Columns: 1400
#> Primary keys: 1
#> Foreign keys: 18
run(dst01_1, syn_data)
#>                                     A: Drug X    B: Placebo   C: Combination   All Patients
#>                                      (N=134)      (N=134)        (N=132)         (N=400)   
#>   —————————————————————————————————————————————————————————————————————————————————————————
#>   Completed Study                   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 Study                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.0%)       12 (3.0%)  
#>     WITHDRAWAL BY PARENT/GUARDIAN    4 (3.0%)     2 (1.5%)       1 (0.8%)        7 (1.8%)  
#>     WITHDRAWAL BY SUBJECT            1 (0.7%)     1 (0.7%)       1 (0.8%)        3 (0.8%)