strate.hlp

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

{smcl}
{* 18mar2005}{...}
{cmd:help strate}, {cmd:help stmc}, {cmd:help stmh} {right:dialogs:  {bf:{dialog strate}}  {bf:{dialog stmh}}  {bf:{dialog stmc}}}
{hline}

{title:Title}

{p2colset 5 20 22 2}{...}
{p2col :{hi:[ST] strate} {hline 2}}Tabulate failure rates and rate ratios{p_end}
{p2colreset}{...}


{title:Syntax}

{phang}
Tabulate failure rates

{p 8 15 2}
{cmd:strate} [{varlist}] {ifin} [{cmd:,}
      {it:{help strate##strate_options:strate_options}}] 

{phang}
Calculate rate ratios using Mantel-Haenszel method

{p 8 15 2}
{cmd:stmh} {varname} [{varlist}] {ifin} [{cmd:,}
       {it:{help strate##options:options}}] 

{phang}
Calculate rate ratios using Mantel-Cox method

{p 8 15 2}
{cmd:stmc} {varname} [{varlist}] {ifin} [{cmd:,}
        {it:{help strate##options:options}}]

{synoptset 28 tabbed}{...}
{marker strate_options}{...}
{synopthdr:strate_options}
{synoptline}
{syntab:Main}
{synopt :{opt per(#)}}units to be used in reported rates{p_end}
{synopt :{opth smr(varname)}}use {it:varname} as reference-rate variable to calculate SMRs{p_end}
{synopt :{opth cl:uster(varname)}}cluster variable to be used by the jackknife{p_end}
{synopt :{opt j:ackknife}}report jackknife confidence intervals{p_end}
{synopt :{opt m:iss}}include missing values as extra categories{p_end}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{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}
{synopt :{opt noli:st}}suppress listed output{p_end}
{synopt :{opt g:raph}}graph rates against exposure category{p_end}
{synopt :{opt now:hisker}}omit confidence intervals from the graph{p_end}

{syntab:Plot}
{synopt :{it:{help marker_options}}}change look of markers (color, size, etc.){p_end}
{synopt :{it:{help marker_label_options}}}add marker labels; change look or position{p_end}
{synopt :{it:{help cline_options}}}affect rendition of the plotted points{p_end}

{syntab:CI plot}
{synopt :{opth "ciopts(line_options)"}}affect rendition of the confidence intervals (whiskers){p_end}

{syntab:Add plot}
{synopt :{opth "addplot(addplot_option:plot)"}}add other plots to the generated graph{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}
{synoptline}
{p2colreset}{...}

{synoptset 22 tabbed}{...}
{marker options}{...}
{synopthdr}
{synoptline}
{syntab:Main}
{synopt :{opth by(varlist)}}tabulate rate ratio on {it:varlist}{p_end}
{synopt :{opt c:ompare(num1,den2)}}compare categories of exposure variable{p_end}
{synopt :{opt m:iss}}include missing values as extra categories{p_end}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synoptline}
{p2colreset}{...}

{p 4 6 2}You must {cmd:stset} your data before using {cmd:strate}, {cmd:stmh}, and {stmc}; see {helpb stset}.{p_end}
{p 4 6 2}{opt by} may be used with {cmd:stmh} and {cmd:stmc}; see {helpb by}.{p_end}
{p 4 6 2}Note that {opt fweight}s, {opt iweight}s, and {opt pweights} may be specified using {cmd:stset}; see {helpb stset}.{p_end}


{title:Description}

{pstd}
{cmd:strate} tabulates rates by one ore more categorical variables declared in
{varlist}.  You can also save an optional summary dataset, which includes
event counts and rate denominators, for further analysis or display.  The
combination of the commands {cmd:stsplit} and {cmd:strate} implements most, if
not all, the functions of the special purpose person-years programs in
widespread use in epidemiology.

{pstd}
{cmd:stmh} calculates stratified rate ratios and significance tests using a
Mantel-Haenszel-type method.

{pstd}
{cmd:stmc} calculates rate ratios that are stratified finely by using the
Mantel-Cox method.  The corresponding significance test (the log-rank test) is
also calculated.

{pstd}
Both {cmd:stmh} and {cmd:stmc} can estimate the failure rate ratio for two
categories of the explanatory variable specified by the first argument of
{it:varlist}.  You can define categories to be compared by specifying them
with the {opt compare()} option.  The remaining variables in {opt varlist}
before the comma are categorical variables, which are to be "controlled for"
using stratification.  Strata are defined by cross-classification of these
variables.

{pstd}
Alternatively, you can use {cmd:stmh} and {cmd:stmc} to carry out trend tests
for a metric explanatory variable.  In this case, a one-step Newton
approximation to the log-linear Poisson regression coefficient is computed.


{title:Options for strate}

{dlgtab:Main}

{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 1000 person-years.

{phang}
{opth smr(varname)} specifies a reference-rate variable.  {cmd:strate} then
calculates SMRs rather than rates.  This option will usually follow using
{cmd:stsplit} to split the follow-up records by age bands and possibly
calendar periods.

{phang}
{opth cluster(varname)} defines a categorical variable that indicates clusters
of data to be used by the jackknife.  If the {opt jackknife} option is
selected and this option is not specified, the cluster variable is taken as
the {opt id} variable defined in the st data.  Specifying {opt cluster()}
implies {opt jackknife}.

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

{phang}
{opt miss} specifies that missing values of the explanatory variables be
treated as extra categories.  The default is to exclude such observations.

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

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

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

{phang}
{opt nolist} suppresses the output.  This is used only when saving results to
a file specified by {opt output()}.

{phang}
{opt graph} produces a graph of the rate against the numerical code used for
categories of {varname}.

{phang}
{opt nowhisker} omits the confidence intervals from the graph.

{dlgtab:Plot}

{phang}
{it:marker_options} affect the rendition of markers drawn at the plotted
points, including their shape, size, color, and outline; see 
{it:{help marker_options}}.

{phang}
{it:marker_label_options} specify if and how the markers are to be labeled;
see {it:{help marker_label_options}}.

{phang}
{it:cline_options} affect whether lines connect the plotted points and the
rendition of those lines; see {it:{help cline_options}}.

{dlgtab:CI plot}

{phang}
{opt ciopts(line_options)} affect the rendition of the confidence 
intervals (whiskers); see {it:{help line_options}}.  

{dlgtab:Add plot}

{phang}
{opt addplot(plot)} provides a way to add other plots to the generated graph; 
see {it:{help addplot_option}}.

{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}}).


{title:Options for stmh and stmc}

{dlgtab:Main}

{phang}
{opth by(varlist)} specifies categorical variables by which the rate ratio is
be tabulated.

{pmore}
A separate rate ratio is produced for each category or combination of
categories of {varlist}, and a test for unequal rate ratios (effect
modification) is displayed.

{phang}
{opt compare(num1,den2)} specifies the categories of the exposure variable to be compared.  The first code defines the numerator categories, and the second defines the denominator categories.

{pmore}
When {opt compare} is absent and there are only two categories, the larger is
compared with the smaller; when there are more than two categories, 
{opt compare} analyzes log-linear trend.

{phang}
{opt miss} specifies that missing values of the explanatory variables be
treated as extra categories.  The default is to exclude such observations.

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


{title:Examples}

{phang}{cmd:. strate hienergy, output(mytable) nolist}{p_end}
{phang}{cmd:. strate hienergy, jackknife level(90)}{p_end}
{phang}{cmd:. strate hienergy, smr(ewrate)}


{title:Also see}

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

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