add_overall_level: Add a virtual "overall" level to split

In Roche/rtables: Reporting Tables

Add a virtual "overall" level to split

Description

Add a virtual "overall" level to split

Usage

add_overall_level(
  valname = "Overall",
  label = valname,
  extra_args = list(),
  first = TRUE,
  trim = FALSE
)

Arguments

valname	(string) value to be assigned to the implicit all-observations split level. Defaults to "Overall".
label	(string) a label (not to be confused with the name) for the object/structure.
extra_args	(list) extra arguments to be passed to the tabulation function. Element position in the list corresponds to the children of this split. Named elements in the child-specific lists are ignored if they do not match a formal argument of the tabulation function.
first	(flag) whether the implicit level should appear first (TRUE) or last (FALSE). Defaults to TRUE.
trim	(flag) whether splits corresponding with 0 observations should be kept when tabulating.

Value

A closure suitable for use as a splitting function (splfun) when creating a table layout.

Examples

lyt <- basic_table() %>%
  split_cols_by("ARM", split_fun = add_overall_level("All Patients",
    first = FALSE
  )) %>%
  analyze("AGE")

tbl <- build_table(lyt, DM)
tbl

lyt2 <- basic_table() %>%
  split_cols_by("ARM") %>%
  split_rows_by("RACE",
    split_fun = add_overall_level("All Ethnicities")
  ) %>%
  summarize_row_groups(label_fstr = "%s (n)") %>%
  analyze("AGE")
lyt2

tbl2 <- build_table(lyt2, DM)
tbl2

Roche/rtables documentation built on April 20, 2024, 9:16 p.m.