rtables (version 0.6.1)

add_combo_facet: 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())

Value

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

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.

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)