chevron (version 0.2.12)

ext01_main: EXT01 Exposure Summary Table.

Description

The EXT01 table provides an overview of the of the exposure of the patients in terms of Total dose administered or missed, and treatment duration.

Usage

ext01_main(
  adam_db,
  arm_var = "ACTARM",
  lbl_overall = NULL,
  summaryvars = "AVAL",
  row_split_var = "PARCAT2",
  page_var = NULL,
  map = NULL,
  stats = list(default = c("n", "mean_sd", "median", "range", "count_fraction")),
  precision = list(default = 0),
  ...
)
ext01_pre(adam_db, ...)
ext01_post(tlg, prune_0 = TRUE, ...)
ext01

Value

the main function returns an rtables object.

the preprocessing function returns a list of data.frame.

the postprocessing function returns an rtables object or an ElementaryTable (null report).

Format

An object of class chevron_t of length 1.

Arguments

adam_db

(list of data.frames) object containing the ADaM datasets

arm_var

(string) variable used for column splitting

lbl_overall

(string) label used for overall column, if set to NULL the overall column is omitted

summaryvars

(character) variables to be analyzed. The label attribute of the corresponding column in adex table of adam_db is used as label.

row_split_var

(character) additional row split variables.

page_var

(string) variable name prior to which the row split is by page.

map

(data.frame) of mapping for split rows.

stats

(named list of character) where names are values found in the PARAMCD column and the values indicate the statistical analysis to perform. If default is set, and parameter precision not specified, the value for default will be used.

precision

(named list of integer) where names are values found in the PARAMCD column and the values

...

not used.

tlg

(TableTree, Listing or ggplot) object typically produced by a main function.

prune_0

(flag) remove 0 count rows

Functions

• ext01_main(): Main TLG function

• ext01_pre(): Preprocessing

• ext01_post(): Postprocessing

Details

• Default Exposure table

• The n row provides the number of non-missing values. The percentages for categorical variables is based on n. The percentages for Total number of patients with at least one dose modification are based on the number of patients in the corresponding analysis population given by N.

• Split columns by arm, typically ACTARM.

• Does not include a total column by default.

• Sorted by alphabetic order of the PARAM value. Transform to factor and re-level for custom order.

• ANL01FL is not relevant subset.

Examples

run(ext01, syn_data)

run(ext01, syn_data, summaryvars = c("AVAL", "AVALCAT1"), prune_0 = FALSE)

levels(syn_data$adex$AVALCAT1) <- c(levels(syn_data$adex$AVALCAT1), "12 months")
map <- data.frame(
  PARAMCD = "TDURD",
  AVALCAT1 = c("< 1 month", "1 to <3 months", ">=6 months", "3 to <6 months", "12 months")
)
run(
  ext01,
  syn_data,
  summaryvars = c("AVAL", "AVALCAT1"),
  prune_0 = FALSE,
  map = map,
  precision = list(TDOSE = 4, default = 4),
  stats = list(TDURD = "n", default = c("n", "count_fraction"))
)