sts_list.hlp

是一个经济学管理应用软件 很难找的 但是经济学学生又必须用到

{smcl}
{* 18mar2005}{...}
{cmd:sts list} {right:dialog:  {bf:{dialog stslist:sts list}}}
{hline}

{title:Title}

{p2colset 5 22 24 2}{...}
{p2col :{hi:[ST] sts list} {hline 2}}List the survivor and cumulative hazard functions{p_end}
{p2colreset}{...}


{title:Syntax}

{p 8 21 2}{cmd:sts} {opt l:ist} {ifin} [{cmd:,} {it:options}]

{synoptset 21 tabbed}{...}
{synopthdr}
{synoptline}
{syntab:Main}
{synopt :{opt f:ailure}}report Kaplan-Meier failure function; default is to report the survivor function{p_end}
{synopt :{opt na}}report Nelson-Aalen cumulative hazard function{p_end}
{synopt :{opth by(varlist)}}perform calculation separately on different groups of {it:varlist}{p_end}
{synopt :{opth a:djustfor(varlist)}}adjust the estimates to zero values of {it:varlist}{p_end}
{synopt :{opth st:rata(varlist)}}perform calculation separately on different groups of {it:varlist}{p_end}

{syntab:Options}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synopt :{opt at(#|numlist)}}report estimated survivor/cumulative hazard function at specified times; default is to report at all unique time values{p_end}
{synopt :{opt e:nter}}report number lost as pure censored instead of censored minus lost{p_end}
{synopt :{opt nosh:ow}}do not show st setting information{p_end}
{synopt :{opt c:ompare}}report groups of survivor/cumulative hazard functions side-by-side{p_end}
{synoptline}
{p2colreset}{...}
{p 4 6 2}
You must {cmd:stset} your data before using {cmd:sts list}; see {helpb stset}.{p_end}
{p 4 6 2}
Note that {opt fweight}s, {opt iweight}s, and {opt pweight}s may be specified using {cmd:stset}; see {helpb stset}.


{title:Description}

{pstd}
{cmd:sts list} lists the estimated survivor (failure) or the Nelson-Aalen
estimated cumulative (integrated) hazard function.  See {help sts} for an
introduction to this command.

{pstd}
{cmd:sts generate} can be used with single- or multiple-record or single- or
multiple-failure st data.


{title:Options}

{dlgtab:Main}

{phang}
{opt failure} specifies that the failure function 1-S(t+0) be listed.

{phang}
{opt na} requests that the Nelson-Aalen estimate of the cumulative hazard
function be listed.

{phang}
{opth by(varlist)} produces separate survivor or cumulative hazard functions
by making separate calculations for each group identified by equal values of
the variables in {it:varlist}.

{phang}
{opth adjustfor(varlist)} adjusts the estimate of the survivor function to
that for 0 values of the {it:varlist} specified.  This option is not available
with the Nelson-Aalen function.

{pmore}
If you specify {opt strata()}, {cmd:sts} performs the adjustment by estimating
a stratified-on-group Cox regression model using {opt adjustfor()} as the
covariates.  The stratified, baseline survivor function is then retrieved.

{pmore}
If you specify {opt by()}, {cmd:sts} fits separate Cox regression models for
each group and retrieves the separately calculated baseline survivor
functions.

{pmore}
Be aware that, regardless of the method employed, the survivor function is
adjust to 0 values of the covariates.

{phang}
{opth strata(varlist)} is a subtle alternative to {opt by()}.  You may
not specify {opt strata()} unless you also specify {opt adjustfor()}, whereas
you may specify {opt by()} in either case.  Thus {opt strata()} amounts to a
modifier of {opt adjustfor()}.  This option is not available with the
{opt na} function.

{dlgtab:Options}

{phang}
{opt level(#)} specifies the confidence level, as a percentage, for the
Greenwood pointwise confidence interval of the survivor (failure) or for the
pointwise confidence interval of the Nelson-Aalen cumulative hazard function;
see {help level}.

{phang}
{opt at(#|numlist)} specifies the time values at which the estimated survivor
(failure) or cumulative hazard function is to be listed.

{pmore}
The default is to list the function at all the unique time values in
the data or, if functions are being compared, at about 10 times chosen over
the observed interval.  In any case, you can control the points chosen.

{pmore}
{cmd:at(5 10 20 30 50 90)} would display the function at the designated
times.

{pmore}
{cmd:at(10 20 to 100)} would display the function at times 10, 20, 30, 40, ...,
100.

{pmore}
{cmd:at(0 5 10 to 100 200)} would display the function at times 0, 5, 10, 15,
..., 100, and 200.

{pmore}
{cmd:at(20)} displays the curve at (roughly) 20 equally spaced times over the
interval observed in the data.  We say roughly because Stata may choose to
increase or decrease your number slightly if that would result in rounder
values of the chosen times.

{phang}
{opt enter} specifies that the table contain the number who enter, and,
correspondingly, that the number lost be displayed as the pure number censored
rather than censored-minus-entered; see {bf:[ST] sts}.

{phang}
{opt noshow} prevents {cmd:sts list} from displaying the key st variables.
This option is seldom used since most people type {cmd:stset , show} or
{cmd:stset, noshow} to set whether they want to see these variables mentioned
at the top of the output of every st command; see {helpb stset}.

{phang}
{opt compare} is specified only with {opt by()} or {opt strata()}.  It
compares the survival (failure) or cumulative hazard functions and lists them
side by side rather than first one and then the next.


{title:Examples}

    {cmd:. sts list}
{phang}{cmd:. sts list, na}{p_end}
{phang}{cmd:. sts list, by(posttran)}{p_end}
{phang}{cmd:. sts list, by(posttran) compare}{p_end}
{phang}{cmd:. sts list, by(posttran) compare at(0 100 to 1700)}{p_end}
{phang}{cmd:. sts list, na by(posttran) compare at(0 100 to 1700)}

{phang}{cmd:. gen age50 = age - 50}{p_end}
{phang}{cmd:. sts graph, by(drug) adjustfor(age50)}{p_end}
{phang}{cmd:. sts graph, strata(drug) adjustfor(age50)}{p_end}
{phang}{cmd:. sts list, by(drug) adjustfor(age50) compare}{p_end}
{phang}{cmd:. sts list, strata(drug) adjustfor(age50) compare}


{title:Also see}

{psee}
Manual:  {bf:[ST] sts list}

{psee}
Online: {help st}, {helpb sts generate}, {helpb sts graph}, {helpb sts test},
{helpb stset}
{p_end}