CMT01A Table 1 (Default) Concomitant Medication by Medication Class and Preferred Name.

A concomitant medication table with the number of subjects and the total number of treatments by medication class sorted alphabetically and medication name sorted by frequencies.

Usage

cmt01a_1_main(
  adam_db,
  arm_var = "ARM",
  medcat_var = "ATC2",
  lbl_medcat_var = "ATC Class Level 2",
  medname_var = "CMDECOD",
  lbl_medname_var = "Other Treatment",
  lbl_overall = NULL,
  deco = std_deco("CMT01A"),
  ...
)

cmt01a_1_lyt(
  arm_var,
  lbl_overall,
  medcat_var,
  lbl_medcat_var,
  medname_var,
  lbl_medname_var,
  deco
)

cmt01a_1_pre(adam_db, medcat_var = "ATC2", medname_var = "CMDECOD", ...)

cmt01a_1_post(
  tlg,
  prune_0 = TRUE,
  medcat_var = "ATC2",
  medname_var = "CMDECOD",
  ...
)

cmt01a_1

Format

An object of class chevron_t of length 1.

Arguments

adam_db: (dm) object containing the ADaM datasets
arm_var: (character) variable used for column splitting
medcat_var: (character) the variable defining the medication category. By default ATC2.
lbl_medcat_var: (character) the label for the medication category.
medname_var: (character) the variable defining the medication name. By default CMDECOD.
lbl_medname_var: (character) the label for the medication name.
lbl_overall: (character) 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.
tlg: (TableTree, Listing or ggplot) object typically produced by a main function.
prune_0: (logical) remove 0 count rows

Details

Data should be filtered for concomitant medication. (ATIREL == "CONCOMITANT").
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.
Split columns by arm.
Does not include a total column by default.
Sort by medication class alphabetically and within medication class by decreasing total number of patients with the specific medication.

Functions

cmt01a_1_main(): Main TLG function
cmt01a_1_lyt(): Layout
cmt01a_1_pre(): Preprocessing
cmt01a_1_post(): Postprocessing

Note

adam_db object must contain an adcm table with the columns specified in medcat_var and medname_var as well as "CMSEQ".

Examples

library(magrittr)
library(dm)
#> 
#> Attaching package: ‘dm’
#> The following object is masked from ‘package:stats’:
#> 
#>     filter

db <- syn_data %>%
  dm_zoom_to("adcm") %>%
  filter(.data$ATIREL == "CONCOMITANT") %>%
  dm_update_zoomed()

run(cmt01a_1, db)
#>   ATC Class Level 2                                         A: Drug X    B: Placebo    C: Combination
#>     Other Treatment                                          (N=134)       (N=134)        (N=132)    
#>   ———————————————————————————————————————————————————————————————————————————————————————————————————
#>   Total number of patients with at least one treatment     117 (87.3%)   116 (86.6%)    116 (87.9%)  
#>   Total number of treatments                                   415           414            460      
#>   ATCCLAS2 A                                                                                         
#>     Total number of patients with at least one treatment   75 (56.0%)    79 (59.0%)      81 (61.4%)  
#>     Total number of treatments                                 134           137            143      
#>     medname A_2/3                                          53 (39.6%)    50 (37.3%)      56 (42.4%)  
#>     medname A_3/3                                          45 (33.6%)    54 (40.3%)      48 (36.4%)  
#>   ATCCLAS2 A p2                                                                                      
#>     Total number of patients with at least one treatment   45 (33.6%)    54 (40.3%)      48 (36.4%)  
#>     Total number of treatments                                 58            66              64      
#>     medname A_3/3                                          45 (33.6%)    54 (40.3%)      48 (36.4%)  
#>   ATCCLAS2 B                                                                                         
#>     Total number of patients with at least one treatment   83 (61.9%)    74 (55.2%)      88 (66.7%)  
#>     Total number of treatments                                 141           137            162      
#>     medname B_1/4                                          52 (38.8%)    57 (42.5%)      59 (44.7%)  
#>     medname B_4/4                                          50 (37.3%)    45 (33.6%)      55 (41.7%)  
#>   ATCCLAS2 B p2                                                                                      
#>     Total number of patients with at least one treatment   52 (38.8%)    57 (42.5%)      59 (44.7%)  
#>     Total number of treatments                                 75            82              83      
#>     medname B_1/4                                          52 (38.8%)    57 (42.5%)      59 (44.7%)  
#>   ATCCLAS2 B p3                                                                                      
#>     Total number of patients with at least one treatment   52 (38.8%)    57 (42.5%)      59 (44.7%)  
#>     Total number of treatments                                 75            82              83      
#>     medname B_1/4                                          52 (38.8%)    57 (42.5%)      59 (44.7%)  
#>   ATCCLAS2 C                                                                                         
#>     Total number of patients with at least one treatment   82 (61.2%)    84 (62.7%)      89 (67.4%)  
#>     Total number of treatments                                 140           140            155      
#>     medname C_2/2                                          52 (38.8%)    58 (43.3%)      60 (45.5%)  
#>     medname C_1/2                                          51 (38.1%)    50 (37.3%)      56 (42.4%)  
#>   ATCCLAS2 C p2                                                                                      
#>     Total number of patients with at least one treatment   82 (61.2%)    84 (62.7%)      89 (67.4%)  
#>     Total number of treatments                                 140           140            155      
#>     medname C_2/2                                          52 (38.8%)    58 (43.3%)      60 (45.5%)  
#>     medname C_1/2                                          51 (38.1%)    50 (37.3%)      56 (42.4%)  
#>   ATCCLAS2 C p3                                                                                      
#>     Total number of patients with at least one treatment   52 (38.8%)    58 (43.3%)      60 (45.5%)  
#>     Total number of treatments                                 69            73              80      
#>     medname C_2/2                                          52 (38.8%)    58 (43.3%)      60 (45.5%)