Summarize categorical data

cat_data(
  data,
  cols,
  by = ".total",
  panel = by,
  summarize_all = TRUE,
  all_name = "All",
  wide = FALSE,
  nby = NULL
)

Arguments

data: the data frame to summarize; the user should filter or subset so that data contains exactly the records to be summarized; pmtables will not add or remove rows prior to summarizing data
cols: the columns to summarize; may be character vector or quosure
by: a grouping variable; may be character vector or quosure
panel: data set column name to stratify the summary
summarize_all: logical indicating whether or not to include a summary of the full data in the output
all_name: label for full data summary
wide: logical; if TRUE, data frame will be returned in wide format; if FALSE, it will be returned in long format
nby: number of unique levels for the by variable

Examples


cat_data(pmt_first, cols = c(SEX = "SEXf", RF = "RFf"), by = "STUDYf")
#> # A tibble: 6 × 6
#>   name  level    `12-DEMO-001` `12-DEMO-002` `11-DEMO-005` `13-DEMO-001`
#>   <chr> <chr>    <chr>         <chr>         <chr>         <chr>        
#> 1 SEX   male     10 (33.3)     18 (36.0)     29 (72.5)     23 (57.5)    
#> 2 SEX   female   20 (66.7)     32 (64.0)     11 (27.5)     17 (42.5)    
#> 3 RF    normal   30 (100.0)    50 (100.0)    10 (25.0)     40 (100.0)   
#> 4 RF    mild     0 (0.0)       0 (0.0)       10 (25.0)     0 (0.0)      
#> 5 RF    moderate 0 (0.0)       0 (0.0)       10 (25.0)     0 (0.0)      
#> 6 RF    severe   0 (0.0)       0 (0.0)       10 (25.0)     0 (0.0)