stcurve.hlp

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

{smcl}
{* 18mar2005}{...}
{cmd:help stcurve} {right:dialog:  {bf:{dialog stcurve}}}
{hline}

{title:Title}

{p2colset 5 21 23 2}{...}
{p2col :{hi:[ST] stcurve} {hline 2}}Plot survival, hazard, or cumulative hazard function{p_end}
{p2colreset}{...}


{title:Syntax}

{p 8 16 2}
{cmd:stcurve} [{cmd:,} {it:stcurve_options}]

{synoptset 34 tabbed}{...}
{synopthdr :stcurve_options}
{synoptline}
{syntab:Main}
{p2coldent :* {opt sur:vival}}plot survival function{p_end}
{p2coldent :* {opt haz:ard}}plot hazard function{p_end}
{p2coldent :* {opt cumh:az}}plot cumulative hazard function{p_end}
{synopt :{cmd:at(}{varname}{cmd:=}{it:#} [{it:varname}{cmd:=}{it:# ...}]{cmd:)}}value of the specified covariates and{p_end}
{synopt :[{cmd:at1(}{it:varname}{cmd:=}{it:#} [{it:varname}{cmd:=}{it:# ...}]{cmd:)}}mean of unspecified covariates{p_end}
{synopt :[{cmd:at2(}{it:varname}{cmd:=}{it:#} [{it:varname}{cmd:=}{it:# ...}]{cmd:)}}{p_end}

{syntab:Options}
{synopt :{opt alpha:1}}conditional frailty model{p_end}
{synopt :{opt uncond:itional}}unconditional frailty model{p_end}
{synopt :{opt r:ange(# #)}}range of analysis time{p_end}
{synopt :{opt width(#)}}override "optimal" width; use with {opt hazard}{p_end}
{synopt :{opt k:ernel(kernel)}}kernel function; use with {opt hazard}{p_end}
{synopt :{cmdab:out:file:(}{it:filename} [{cmd:,} {opt replace}]{cmd:)}}save values used to plot the curves{p_end}

{syntab:Y-Axis, X-Axis, Title, Caption, Legend, Overall}
{synopt :{it:{help twoway_options}}}any options other than {opt by()} documented in {bind:{bf:[G] {it:twoway_options}}}{p_end}

{syntab:Overall}
{synopt :{it:{help connect_options:plot_options}}}affect rendition of plotted survival, hazard, or cumulative hazard function{p_end}
{synoptline}
{p2colreset}{...}
{p 4 6 2}* One of {opt cumhaz}, {opt survival}, or {opt hazard} must be specified.


{title:Description}

{pstd}
{cmd:stcurve} plots the survival, hazard, or cumulative hazard function after
{cmd:stcox} or {cmd:streg}.


{title:Options}

{dlgtab:Main}

{phang}
{opt survival} requests that the survival function be plotted.

{phang}
{opt hazard} requests that the hazard function be plotted.

{phang}
{opt cumhaz} requests that the cumulative hazard function be plotted.

{phang}
{cmd:at(}{varname}{cmd:=}{it:# ...}{cmd:)} requests that the
covariates specified by {it:varname} be set to {it:#}. By default,
{cmd:stcurve} evaluates the function by setting each covariate to its mean
value.  This option causes the function to be evaluated at the value of the
covariates listed in {opt at()} and at the mean of all unlisted covariates.

{phang}
{cmd:at1(}{varname}{cmd:=}{it:# ...}{cmd:)},
{cmd:at2(}{varname}{cmd:=}{it:# ...}{cmd:)}, ...,
{cmd:at10(}{varname}{cmd:=}{it:# ...}{cmd:)} specify that multiple curves
(up to 10) be plotted on the same graph.  {opt at1()}, {opt at2()}, ...,
{opt at10()} work like the {opt at()} option.  They request that the function
be evaluated at the value of the covariates specified and at the mean of
all unlisted covariates.  {opt at1()} specifies the values of the covariates
for the first curve, {opt at2()} specifies the values of the covariates for
the second curve, and so on.

{dlgtab:Options}

{phang}
{opt alpha1}, when used after fitting a frailty model, plots curves
that are conditional on a frailty value of one.  This is the default for
shared-frailty models.

{phang}
{opt unconditional}, when used after fitting a frailty model, plots
curves that are unconditional on the frailty; i.e., the curve is "averaged"
over the frailty distribution.  This is the default for unshared-frailty
models.

{phang}
{opt range(# #)} specifies the range of the time axis to be plotted.  If this
option is not specified, {cmd:stcurve} will plot the desired curve on an
interval expanding from the earliest to the latest time in the data.

{phang}
{opt width(#)} is for use with {opt hazard} (and only applies after
{cmd:stcox}) and is used to specify the bandwidth to be used in the kernel
smooth used to plot the estimated hazard function.  If left unspecified, a
default bandwidth is used; see {helpb kdensity}.

{phang}
{opt kernel(kernel)} is for use with {opt hazard} and is only for use after
{cmd:stcox} since, in the case of Cox regression, an estimate of the hazard
function is obtained by smoothing the estimated {it:hazard contributions}.
{opt kernel()} specifies the kernel function for use in calculating the
weighted kernel-density estimate required to produce a smoothed hazard
function estimator.  The default kernel is Epanechinikov, yet {it:kernel} may
be any of the kernels supported by {cmd:kdensity}; see {helpb kdensity}.

{phang}
{cmd:outfile(}{it:filename} [{cmd:,} {opt replace}]{cmd:)} saves in
{it:filename}{cmd:.dta} the values used to plot the curve(s).

{dlgtab:Y-Axis, X-Axis, Title, Caption, Legend, Overall}

{phang}
{it:twoway_options} and are any of the options documented in
{it:{help twoway_options}}, excluding {opt by()}.  These include options for
titling the graph (see {it:{help title_options}}) and options for saving the
graph to disk (see {it:{help saving_option}}).

{dlgtab:Overall}

{phang}
{it:plot_options} affect the rendition of the plotted survival, hazard, or
cumulative hazard function; see {help connect_options}.


{title:Examples}

{phang}{cmd:. stcurve, cumhaz}{p_end}
{phang}{cmd:. stcurve, cumhaz at(drug=1)}{p_end}
{phang}{cmd:. stcurve, cumhaz at(drug=1, age=40)}{p_end}
{phang}{cmd:. stcurve, cumhaz at(drug=1, age=40) range(0,50)}


{title:Also see}

{psee}
Manual:  {bf:[ST] stcurve}

{psee}
Online:  {helpb stcox}, {help stcox postestimation}, 
{helpb streg}, {help streg postestimation};{break}
{help st}, {helpb sts}, {helpb stset}
{p_end}