vst01: 'VST01' Vital Sign Results and change from Baseline By Visit...

In chevron: Standard TLGs for Clinical Trials Reporting

VST01 Vital Sign Results and change from Baseline By Visit Table.

Description

The VST01 table provides an overview of the Vital Sign values and its change from baseline of each respective arm over the course of the trial.

Usage

vst01_main(
  adam_db,
  dataset = "advs",
  arm_var = "ACTARM",
  lbl_overall = NULL,
  row_split_var = NULL,
  summaryvars = c("AVAL", "CHG"),
  visitvar = "AVISIT",
  precision = list(DIABP = 0, PUL = 0, SYSBP = 0, default = 2L),
  page_var = "PARAMCD",
  .stats = c("n", "mean_sd", "median", "range"),
  skip = list(CHG = "BASELINE"),
  ...
)

vst01_pre(adam_db, dataset = "advs", ...)

vst01

Arguments

adam_db	(list of data.frames) object containing the ADaM datasets
dataset	(string) the name of a table in the adam_db object.
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
row_split_var	(character) additional row split variables.
summaryvars	(character) variables to be analyzed. The label attribute of the corresponding column in table of adam_db is used as label.
visitvar	(string) typically one of "AVISIT" or user-defined visit incorporating "ATPT".
precision	(named list of integer) where names are values found in the PARAMCD column and the values indicate the number of digits in statistics. If default is set, and parameter precision not specified, the value for default will be used. If default is not set, the default precision is 2.
page_var	(string) variable name prior to which the row split is by page.
.stats	(character) statistics names, see tern::analyze_vars().
skip	Named (list) of visit values that need to be inhibited.
...	additional arguments like .indent_mods, .labels.

Format

An object of class chevron_t of length 1.

Details

• The ⁠Analysis Value⁠ column, displays the number of patients, the mean, standard deviation, median and range of the analysis value for each visit.

• The ⁠Change from Baseline⁠ column, displays the number of patient and the mean, standard deviation, median and range of changes relative to the baseline.

• Remove zero-count rows unless overridden with prune_0 = FALSE.

• Split columns by arm, typically ACTARM.

• Does not include a total column by default.

• Sorted based on factor level; first by PARAM labels in alphabetic order then by chronological time point given by AVISIT. Re-level to customize order

Value

the main function returns an rtables object.

the preprocessing function returns a list of data.frame.

Functions

• vst01_main(): Main TLG function

• vst01_pre(): Preprocessing

Note

• adam_db object must contain table named as dataset with the columns specified in summaryvars.

Examples

library(dunlin)

proc_data <- log_filter(
  syn_data,
  PARAMCD %in% c("DIABP", "SYSBP"), "advs"
)
run(vst01, proc_data)

chevron documentation built on June 20, 2025, 5:08 p.m.