Learn R Programming

survival (version 2.38-3)

summary.survfit: Summary of a Survival Curve

Description

Returns a list containing the survival curve, confidence limits for the curve, and other information.

Usage

## S3 method for class 'survfit':
summary(object, times=, censored=FALSE, scale=1,
  extend=FALSE, rmean=getOption('survfit.rmean'), ...)

Arguments

object
the result of a call to the survfit function.
times
vector of times; the returned matrix will contain 1 row for each time. The vector will be sorted into increasing order; missing values are not allowed. If censored=T, the default times vector contains all t
censored
logical value: should the censoring times be included in the output? This is ignored if the times argument is present.
scale
numeric value to rescale the survival time, e.g., if the input data to survfit were in days, scale = 365.25 would scale the output to years.
extend
logical value: if TRUE, prints information for all specified times, even if there are no subjects left at the end of the specified times. This is only valid if the times argument is present.
rmean
Show restricted mean: see print.survfit for details
...
for future methods

Value

  • a list with the following components:
  • survthe estimate of survival at time t+0.
  • timethe timepoints on the curve.
  • n.riskthe number of subjects at risk at time t-0 (but see the comments on weights in the survfit help file).
  • n.eventif the times argument is missing, then this column is the number of events that occurred at time t. Otherwise, it is the cumulative number of events that have occurred since the last time listed until time t+0.
  • n.enteredThis is present only for counting process survival data. If the times argument is missing, this column is the number of subjects that entered at time t. Otherwise, it is the cumulative number of subjects that have entered since the last time listed until time t.
  • n.exit.censoredif the times argument is missing, this column is the number of subjects that left without an event at time t. Otherwise, it is the cumulative number of subjects that have left without an event since the last time listed until time t+0. This is only present for counting process survival data.
  • std.errthe standard error of the survival value.
  • conf.intlevel of confidence for the confidence intervals of survival.
  • lowerlower confidence limits for the curve.
  • upperupper confidence limits for the curve.
  • strataindicates stratification of curve estimation. If strata is not NULL, there are multiple curves in the result and the surv, time, n.risk, etc. vectors will contain multiple curves, pasted end to end. The levels of strata (a factor) are the labels for the curves.
  • callthe statement used to create the fit object.
  • na.actionsame as for fit, if present.
  • tabletable of information that is returned from print.survfit function.
  • typetype of data censoring. Passed through from the fit object.

See Also

survfit, print.summary.survfit

Examples

Run this code
summary( survfit( Surv(futime, fustat)~1, data=ovarian))
summary( survfit( Surv(futime, fustat)~rx, data=ovarian))

Run the code above in your browser using DataLab