SHELF (version 1.12.0)

makeSurvivalTable: 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
)

Value

a data frame with survivor function estimates, 95

and within interval hazard estimates for each time interval.

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

Examples

if (FALSE) {
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")
}