Skip to contents

DTHT01 Table 1 (Default) Death Table.

Source: R/dtht01.R
dtht01.Rd

A description of the causes of death optionally with the breakdown of the OTHER category and/or post-study reporting of death.

Usage 

dtht01_main(
  adam_db,
  arm_var = "ACTARM",
  lbl_overall = NULL,
  other_category = FALSE,
  time_since_last_dose = FALSE,
  ...
)

dtht01_pre(adam_db, ...)

dtht01_post(tlg, prune_0 = TRUE, ...)

dtht01

Format

An object of class chevron_t of length 1.

Arguments

adam_db

(list of data.frames) object containing the ADaM datasets

arm_var

(string) variable used for column splitting

lbl_overall

(string) label used for overall column, if set to NULL the overall column is omitted

other_category

(flag) should the breakdown of the OTHER category be displayed.

time_since_last_dose

(flag) should the time to event information be displayed.

...

not used.

tlg

(TableTree, Listing or ggplot) object typically produced by a main function.

prune_0

(flag) remove 0 count rows

Value

the main function returns an rtables object.

the preprocessing function returns a list of data.frame.

the postprocessing function returns an rtables object or an ElementaryTable (null report).

Details

  • Numbers represent absolute numbers of subjects and fraction of N, or absolute numbers when specified.

  • Remove zero-count rows unless overridden with prune_0 = FALSE.

  • Does not include a total column by default.

Functions

  • dtht01_main(): Main TLG function

  • dtht01_pre(): Preprocessing

  • dtht01_post(): Postprocessing

Note

  • adam_db object must contain an adsl table with the columns "DTHFL", "DTHCAT" as well as LDDTHGR1 if time_since_last_dose is TRUE.

Examples 

run(dtht01, syn_data)
#>                            A: Drug X    B: Placebo   C: Combination
#>                             (N=134)      (N=134)        (N=132)    
#>   —————————————————————————————————————————————————————————————————
#>   Total number of deaths   25 (18.7%)   23 (17.2%)     22 (16.7%)  
#>   Primary Cause of Death                                           
#>     n                          25           23             22      
#>     Adverse Event          9 (36.0%)    7 (30.4%)      10 (45.5%)  
#>     Progressive Disease    8 (32.0%)    6 (26.1%)      6 (27.3%)   
#>     Other                  8 (32.0%)    10 (43.5%)     6 (27.3%)   

run(dtht01, syn_data, other_category = TRUE, time_since_last_dose = TRUE)
#>                                                               A: Drug X    B: Placebo   C: Combination
#>                                                                (N=134)      (N=134)        (N=132)    
#>   ————————————————————————————————————————————————————————————————————————————————————————————————————
#>   Total number of deaths                                      25 (18.7%)   23 (17.2%)     22 (16.7%)  
#>   Primary Cause of Death                                                                              
#>     n                                                             25           23             22      
#>     Adverse Event                                             9 (36.0%)    7 (30.4%)      10 (45.5%)  
#>     Progressive Disease                                       8 (32.0%)    6 (26.1%)      6 (27.3%)   
#>     Other                                                     8 (32.0%)    10 (43.5%)     6 (27.3%)   
#>       LOST TO FOLLOW UP                                        2 (8.3%)     2 (8.3%)       2 (8.3%)   
#>       MISSING                                                  2 (8.3%)    3 (12.5%)       2 (8.3%)   
#>       Post-study reporting of death                            1 (4.2%)     2 (8.3%)       1 (4.2%)   
#>       SUICIDE                                                  2 (8.3%)     2 (8.3%)       1 (4.2%)   
#>       UNKNOWN                                                  1 (4.2%)     1 (4.2%)          0       
#>   Days from last drug administration                                                                  
#>     n                                                             25           23             22      
#>     <=30                                                      14 (56.0%)   11 (47.8%)     14 (63.6%)  
#>     >30                                                       11 (44.0%)   12 (52.2%)     8 (36.4%)   
#>   Primary cause by days from last study drug administration                                           
#>     <=30                                                                                              
#>       n                                                           14           11             14      
#>       Adverse Event                                           4 (28.6%)    2 (18.2%)      6 (42.9%)   
#>       Progressive Disease                                     6 (42.9%)    3 (27.3%)      4 (28.6%)   
#>       Other                                                   4 (28.6%)    6 (54.5%)      4 (28.6%)   
#>     >30                                                                                               
#>       n                                                           11           12             8       
#>       Adverse Event                                           5 (45.5%)    5 (41.7%)      4 (50.0%)   
#>       Progressive Disease                                     2 (18.2%)    3 (25.0%)      2 (25.0%)   
#>       Other                                                   4 (36.4%)    4 (33.3%)      2 (25.0%)