add_combo_facet: Add a combination facet in postprocessing

In rtables: Reporting Tables

Add a combination facet in postprocessing

Description

Add a combination facet during postprocessing stage in a custom split fun.

Usage

add_combo_facet(name, label = name, levels, extra = list())

add_overall_facet(name, label, extra = list())

Arguments

name	character(1). Name for the resulting facet (for use in pathing, etc).
label	character(1). Label for the resulting facet.
levels	character. Vector of levels to combine within the resulting facet.
extra	list. Extra arguments to be passed to analysis functions applied within the resulting facet.

Details

For add_combo_facet, the data associated with the resulting facet will be the data associated with the facets for each level in levels, rbound together. In particular, this means that if those levels are overlapping, data that appears in both will be duplicated.

Value

a function which can be used within the post argument in make_split_fun.

See Also

make_split_fun

Other make_custom_split: drop_facet_levels(), make_split_fun(), make_split_result(), trim_levels_in_facets()

Examples

mysplfun <- make_split_fun(post = list(add_combo_facet("A_B", label = "Arms A+B",
                                                       levels = c("A: Drug X", "B: Placebo")),
                                       add_overall_facet("ALL", label = "All Arms")))

lyt <- basic_table(show_colcounts = TRUE) %>%
    split_cols_by("ARM", split_fun = mysplfun) %>%
    analyze("AGE")

tbl <- build_table(lyt, DM)

rtables documentation built on Aug. 30, 2023, 5:07 p.m.