stptime.hlp

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

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

{title:Title}

{p2colset 5 21 23 2}{...}
{p2col :{hi:[ST] stptime} {hline 2}}Calculate person-time, incidence rates, and SMR{p_end}
{p2colreset}{...}


{title:Syntax}

{p 8 16 2}
{cmd:stptime} [{it:{help if}}] [{cmd:,} {it:options}] 

{synoptset 29 tabbed}{...}
{synopthdr}
{synoptline}
{syntab:Main}
{synopt :{opth at(numlist)}}compute person-time at specified intervals; default
is to compute overall person-time and incidence rates{p_end}
{synopt :{opt trim}}exclude observations <= minimum or > maximum of {opt at()}{p_end}
{synopt :{opth by(varname)}}compute incidence rates or SMRs by {it:varname}{p_end}

{syntab:Options}
{synopt :{opt per(#)}}units to be used in reported rates{p_end}
{synopt :{opt dd(#)}}number of decimal digits to be displayed{p_end}
{synopt :{opt smr(groupvar ratevar)}}use {it:groupvar} and {it:ratevar} in {opt using()} dataset to calculate SMRs{p_end}
{synopt :{opt u:sing(filename)}}specify filename to merge that contains {opt smr()} variables{p_end}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synopt :{opt nosh:ow}}do not show st setting information{p_end}

{syntab:Advanced}
{synopt :{opt j:ackknife}}jackknife confidence intervals{p_end}
{synopt :{opt t:itle(string)}}label output table with {it:string}{p_end}
{synopt :{cmdab:out:put:(}{it:filename} [{cmd:,replace}]{cmd:)}}save summary dataset as {it:filename}; use {opt replace} to overwrite existing {it:filename}{p_end}
{synoptline}
{p2colreset}{...}
{p 4 6 2}
You must {cmd:stset} your data before using {cmd:stptime}; see {helpb stset}.{p_end}
{p 4 6 2}
{cmd:by} may be used with {cmd:stptime}; see {helpb by}.{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:stptime} calculates person-time and incidence rates.  {cmd:stptime}
computes standardized mortality/morbidity ratios (SMR) after merging the data 
with a suitable file of standard rates specified with the {opt using()} option.


{title:Options}

{dlgtab:Main}

{phang}
{opth at(numlist)} specifies time intervals at which person-time is to be 
computed.  The intervals are specified in analysis-time t units. If {opt at()} 
is not specified, overall person-time and incidence rates are computed.

{pmore}
If, for example, you specify {cmd:at(5(5)20)} and the {opt trim} option
is not specified, person-time is reported for the intervals t = (0 - 5],
t = (5 - 10], t = (10 -15], and t = (15 - 20].

{phang}
{opt trim} specifies that observations less than or equal to the minimum or 
greater than the maximum value listed in {opt at()} be excluded from the 
computations.

{phang}
{opth by(varname)} specifies a categorical variable by which incidence rates 
or SMR are to be computed.

{dlgtab:Options}

{phang}
{opt per(#)} specifies the units to be used in reported rates.  For example, 
if the analysis time is in years, specifying {cmd:per(1000)} results in rates 
per 1,000 person-years.

{phang}
{opt dd(#)} specifies the maximum number of decimal digits to be reported for 
rates, ratios, and confidence intervals. This option affects only how values 
are displayed, not how they are calculated.

{phang}
{opt smr(groupvar ratevar)} specifies two variables in the {opt using()} 
dataset.  The {it:groupvar} identifies the age-group or calendar-period 
variable used to match the data in memory and the {opt using()} dataset.  
The {it:ratevar} variable contains the appropriate reference rates.  
{cmd:stptime} then calculates SMRs rather than incidence rates.

{phang}
{opt using(filename)} specifies the filename that contains a file of standard 
rates that is to be merged with the data so that SMR can be calculated.

{phang}
{opt level(#)} specifies the confidence level, as a percentage,
for confidence intervals.  The default is {cmd:level(95)} or as set by 
{opt set level}; see {help level}.

{phang}
{opt noshow} prevents {cmd:stptime} from showing 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}.

{dlgtab:Advanced}

{phang}
{opt jackknife} specifies that jackknife confidence intervals be produced.  
This is the default if {opt pweight}s or {opt iweight}s were specified when 
the dataset was {cmd:stset}.

{phang}
{opt title(string)} replaces the default "person-time" label
on the output table with {it:string}. 

{phang}
{cmd:output(}{it:filename} [{cmd:, replace}]{cmd:)} saves a summary dataset in 
{it:filename}.  The file contains counts of failures and person-time, incidence
rates (or SMRs), confidence limits, and categorical variables identifying the 
time intervals.  This dataset could be used for further calculations or simply 
as input to the {cmd:table} command. 

{pmore}
{opt replace} indicates that {it:filename} be overwritten, if it exists.  This 
option is not shown in the dialog box.


{title:Examples}

    {cmd:. stptime}
    {cmd:. stptime, by(drug)}
    {cmd:. stptime, at(20(5)60)}
{phang}{cmd:. stptime, at(20(5)60) by(job)}{p_end}
{phang}{cmd:. stptime, at(20(5)50) smr(agegrp rate) using(reffile)}


{title:Also see}

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

{psee}
Online:  {helpb strate}; {help epitab}, {help st}, {helpb stci},
{helpb stir}, {helpb stset}, {helpb stsplit}
{p_end}