make_split_result: Construct split result object

In rtables: Reporting Tables

Construct split result object

Description

These functions can be used to create or add to a split result in functions which implement core splitting or post-processing within a custom split function.

Usage

make_split_result(values, datasplit, labels, extras = NULL)

add_to_split_result(splres, values, datasplit, labels, extras = NULL)

Arguments

values	character or list(SplitValue). The values associated with each facet
datasplit	list(data.frame). The facet data for each facet generated in the split
labels	character. The labels associated with each facet
extras	NULL or list. Extra values associated with each of the facets which will be passed to analysis functions applied within the facet.
splres	list. A list representing the result of splitting.

Details

These functions does various housekeeping to ensure that the split result list is as the rtables internals expect it, most of which are not relevant to end users.

Value

a named list representing the facets generated by the split with elements values, datasplit, and labels, which are the same length and correspond to each other elementwise.

See Also

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

Examples

splres <- make_split_result(values = c("hi", "lo"),
    datasplit = list(hi = mtcars, lo = mtcars[1:10,]),
    labels = c("more data", "less data"))

splres2 <- add_to_split_result(splres,
    values = "med",
    datasplit = list(med = mtcars[1:20,]),
    labels = "kinda some data")

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