h_grob_median_surv: Helper function to create survival estimation grobs

In tern: Create Common TLGs Used in Clinical Trials

Helper function to create survival estimation grobs

Description

The survival fit is transformed in a grob containing a table with groups in rows characterized by N, median and 95% confidence interval.

Usage

h_grob_median_surv(
  fit_km,
  armval = "All",
  x = 0.9,
  y = 0.9,
  width = grid::unit(0.3, "npc"),
  ttheme = gridExtra::ttheme_default()
)

Arguments

fit_km	(survfit) result of survival::survfit().
armval	(string) used as strata name when treatment arm variable only has one level. Default is "All".
x	(proportion) a value between 0 and 1 specifying x-location.
y	(proportion) a value between 0 and 1 specifying y-location.
width	(grid::unit) width (as a unit) to use when printing the grob.
ttheme	(list) see gridExtra::ttheme_default().

Value

A grob of a table containing statistics N, Median, and ⁠XX% CI⁠ (XX taken from fit_km).

Examples

library(dplyr)
library(survival)
library(grid)

grid::grid.newpage()
grid.rect(gp = grid::gpar(lty = 1, col = "pink", fill = "gray85", lwd = 1))
tern_ex_adtte %>%
  filter(PARAMCD == "OS") %>%
  survfit(formula = Surv(AVAL, 1 - CNSR) ~ ARMCD, data = .) %>%
  h_grob_median_surv() %>%
  grid::grid.draw()

tern documentation built on June 20, 2025, 9:08 a.m.