\HeaderA{summary.survfit}{Summary of a Survival Curve}{summary.survfit}
\aliasA{print.summary.survfit}{summary.survfit}{print.summary.survfit}
\keyword{survival}{summary.survfit}
\begin{Description}\relax
Returns a list containing the survival curve, confidence limits for the
curve, and other information.
\end{Description}
\begin{Usage}
\begin{verbatim}
## S3 method for class 'survfit':
summary(object, times, censored=FALSE, scale=1, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{object}] output from a call to \code{survfit}.

\item[\code{times}] vector of times;
the returned matrix will contain 1 row for each time.
This must be in increasing order and missing values are not allowed.
If \code{censored=T}, the default \code{times} vector contains all the unique times in
\code{fit},
otherwise the default \code{times} vector uses only the event (death) times.

\item[\code{censored}] logical flag: should the censoring times be included in the output?
This is ignored if the \code{times} argument is present.

\item[\code{scale}] rescale the survival time, e.g., if the input data to \code{survfit} were in
days, \code{scale=365.25} would scale the output to years.

\item[\code{...}] other unused arguments
\end{ldescription}
\end{Arguments}
\begin{Value}
a list with the following components
\begin{ldescription}
\item[\code{time}] the timepoint on the curve.

\item[\code{surv}] the value of the survival curve at time t+0.

\item[\code{n.risk}] the number of subjects at risk at time t-0
(but see the comments on weights in the \code{survfit} help file).

\item[\code{n.event}] if the \code{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.

\item[\code{std.err}] the standard error of the survival value.

\item[\code{conf.int}] level of confidence for the confidence intervals of survival.

\item[\code{lower}] lower confidence limits for the curve.

\item[\code{upper}] upper confidence limits for the curve.

\item[\code{strata}] indicates stratification of curve estimation.  If \code{strata} is not \code{NULL},
there are multiple curves in the result and the \code{surv}, \code{time}, \code{n.risk}, etc. 
vectors will contain multiple curves, pasted end to end. 
The levels of \code{strata} (a factor) are the labels for the curves.

\item[\code{call}] the statement used to create the \code{fit} object.

\item[\code{na.action}] passed through from \code{fit}, if present.

\end{ldescription}
\end{Value}
\begin{SeeAlso}\relax
\code{\LinkA{survfit}{survfit}}, \code{\LinkA{print.summary.survfit}{print.summary.survfit}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
summary( survfit( Surv(futime, fustat),data=ovarian))
summary( survfit( Surv(futime, fustat)~rx,data=ovarian))

\end{ExampleCode}
\end{Examples}

