makeSurvivalTable: Tabulate Summary Data for Survival Extrapolation

In SHELF: Tools to Support the Sheffield Elicitation Framework

Tabulate Summary Data for Survival Extrapolation

Description

Tabulates the Kaplan Meier survivor function and within interval hazard at discrete equally spaced time points t_1,...,t_n "Within interval hazard" is defined as (1-S(t_[n+1])) / S_(t_n), using the Kaplan Meier estimate of S(). The table is intended to be included on a summary sheet provided to experts when eliciting judgements about extrapolated survival probabilities.

Usage

makeSurvivalTable(
  survDf,
  breakTime,
  truncationTime,
  timeUnit,
  useWeights = FALSE,
  dp = 2
)

Arguments

survDf	data frame with individual patient data. Needs three columns with names "time", "event" and "treatment" (in that order). For weighted observations (e.g. using propensity scores), include a fourth column "weights". Values in the "event" column should be 0 for a censored observation, and 1 otherwise. The "treatment" column should be included even if there is only one treatment group.
breakTime	duration of each time interval
truncationTime	time point for the end of the last interval
timeUnit	string variable to give unit of time
useWeights	set to TRUE if survDf includes column of weights, as described in specification of survDf. This column is passed on to survival::survfit() as the case weights.
dp	number of decimal places to display

Value

a data frame with survivor function estimates, 95 and within interval hazard estimates for each time interval.

Examples

## Not run: 
sdf <- survival::veteran[, c("time", "status", "trt")]
colnames(sdf) <- c("time", "event", "treatment")
sdf$treatment <- factor(sdf$treatment, labels = c("standard", "test"))
makeSurvivalTable(sdf, breakTime = 50, truncationTime = 250, timeUnit = "months")

## End(Not run)

SHELF documentation built on April 3, 2025, 10:48 p.m.