MHT01 Medical History Table. — mht01

The MHT01 table provides an overview of the subjects medical history by SOC and Preferred Term.

Usage

mht01_label

mht01_main(
  adam_db,
  arm_var = "ARM",
  row_split_var = "MHBODSYS",
  lbl_overall = NULL,
  summary_labels = list(all = mht01_label),
  ...
)

mht01_pre(adam_db, ...)

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

mht01

Format

An object of class character of length 2.

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
row_split_var: (character) additional row split variables.
lbl_overall: (string) label used for overall column, if set to NULL the overall column is omitted
summary_labels: (list) of summarize labels. See details.
...: 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 patients and fraction of N, or absolute number of event when specified.
Remove zero-count rows unless overridden with prune_0 = FALSE.
Split columns by arm.
Does not include a total column by default.
Order by body system alphabetically and within body system and medical condition by decreasing total number of patients with the specific condition. summary_labels is used to control the summary for each level. If "all" is used, then each split will have that summary statistic with the labels. One special case is "TOTAL", this is for the overall population.

Functions

mht01_label: Default labels
mht01_main(): Main TLG function
mht01_pre(): Preprocessing
mht01_post(): Postprocessing

Note

adam_db object must contain an admh table with columns "MHBODSYS" and "MHDECOD".

Examples

run(mht01, syn_data)
#>   MedDRA System Organ Class                                 A: Drug X    B: Placebo    C: Combination
#>     MedDRA Preferred Term                                    (N=134)       (N=134)        (N=132)    
#>   ———————————————————————————————————————————————————————————————————————————————————————————————————
#>   Total number of patients with at least one condition     122 (91.0%)   123 (91.8%)    120 (90.9%)  
#>   Total number of conditions                                   609           622            703      
#>   cl A                                                                                               
#>     Total number of patients with at least one condition   78 (58.2%)    75 (56.0%)      89 (67.4%)  
#>     Total number of conditions                                 132           130            160      
#>     trm A_1/2                                              50 (37.3%)    45 (33.6%)      63 (47.7%)  
#>     trm A_2/2                                              48 (35.8%)    48 (35.8%)      50 (37.9%)  
#>   cl B                                                                                               
#>     Total number of patients with at least one condition   96 (71.6%)    89 (66.4%)      97 (73.5%)  
#>     Total number of conditions                                 185           198            205      
#>     trm B_3/3                                              48 (35.8%)    54 (40.3%)      51 (38.6%)  
#>     trm B_2/3                                              49 (36.6%)    44 (32.8%)      52 (39.4%)  
#>     trm B_1/3                                              47 (35.1%)    49 (36.6%)      43 (32.6%)  
#>   cl C                                                                                               
#>     Total number of patients with at least one condition   67 (50.0%)    75 (56.0%)      79 (59.8%)  
#>     Total number of conditions                                 103           116            129      
#>     trm C_2/2                                              35 (26.1%)    48 (35.8%)      55 (41.7%)  
#>     trm C_1/2                                              43 (32.1%)    46 (34.3%)      43 (32.6%)  
#>   cl D                                                                                               
#>     Total number of patients with at least one condition   96 (71.6%)    90 (67.2%)      98 (74.2%)  
#>     Total number of conditions                                 189           178            209      
#>     trm D_3/3                                              47 (35.1%)    58 (43.3%)      57 (43.2%)  
#>     trm D_1/3                                              50 (37.3%)    42 (31.3%)      51 (38.6%)  
#>     trm D_2/3                                              48 (35.8%)    42 (31.3%)      50 (37.9%)