epitab.hlp

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

{smcl}
{* 18mar2005}{...}
{cmd:help epitab} {right:dialogs:  {bf:{dialog ir}}  {bf:{dialog iri}}  {bf:{dialog cs}} {bf:{dialog csi}}{space 3}}
{right:{bf:{dialog cc}}  {bf:{dialog cci}}  {bf:{dialog mcc}}  {bf:{dialog mcci}}}
{right:{bf:{dialog tabodds}}  {bf:{dialog mhodds}}{space 3}}
{hline}

{title:Title}

{p2colset 5 20 22 2}{...}
{p2col :{hi:[ST] epitab} {hline 2}}Tables for epidemiologists{p_end}
{p2colreset}{...}


{title:Syntax}

{phang}
Cohort studies

{p 8 14 2}{cmd:ir} {it:var_case} {it:var_exposed} {it:var_time} {ifin} {weight}
[{cmd:,} {it:{help epitab##ir_options:ir_options}}]

{p 8 14 2}{cmd:iri} {it:#a #b #N1 #N2} [{cmd:, tb} {opt l:evel(#)}]

{p 8 14 2}{cmd:cs} {it:var_case var_exposed} {ifin} {weight} [{cmd:,} 
{it:{help epitab##cs_options:cs_options}}]

{p 8 14 2}{cmd:csi} {it:#a #b #c #d} [{cmd:,} {it:{help epitab##csi_options:csi_options}}]

{phang}
Case-control studies

{p 8 14 2}{cmd:cc} {it:var_case var_exposed} {ifin} {weight} 
[{cmd:,} {it:{help epitab##cc_options:cc_options}}]

{p 8 14 2}{cmd:cci} {it:#a #b #c #d} [{cmd:,} {it:{help epitab##cci_options:cci_options}}]

{p 8 16 2}{cmd:tabodds} {it:var_case} [{it:expvar}] {ifin} {weight} 
[{cmd:,} {it:{help epitab##tabodds_options:tabodds_options}}]

{p 8 16 2}{cmd:mhodds} {it:var_case} {it:expvar} [{it:vars_adjust}]
{ifin} {weight} [{cmd:,} {it:{help epitab##mhodds_options:mhodds_options}}]

{phang}
Matched case-control studies

{p 8 14 2}{cmd:mcc} {it:var_exposed_case} {it:var_exposed_control} {ifin} 
{weight} [{cmd:, tb} {opt l:evel(#)}]

{p 8 14 2}{cmd:mcci} {it:#a #b #c #d} [{cmd:, tb} {opt l:evel(#)}]

{synoptset 21 tabbed}{...}
{marker ir_options}{...}
{synopthdr :ir_options}
{synoptline}
{syntab:Options}
{synopt :{opth by(varname)}}stratify on {it:varname}{p_end}
{synopt :{opt es:tandard}}combine external weights with within-stratum statistics{p_end}
{synopt :{opt is:tandard}}combine internal weights with within-stratum statistics{p_end}
{synopt :{opth s:tandard(varname)}}combine user-specified weights with within-stratum statistics{p_end}
{synopt :{opt p:ool}}display pooled estimate{p_end}
{synopt :{opt noc:rude}}do not display crude estimate{p_end}
{synopt :{opt noh:om}}do not display homogeneity test{p_end}
{synopt :{opt ird}}calculate standard incidence-rate difference{p_end}
{synopt :{opt tb}}calculate test-based confidence intervals{p_end}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synoptline}
{p2colreset}{...}

{synoptset 21 tabbed}{...}
{marker cs_options}{...}
{synopthdr :cs_options}
{synoptline}
{syntab:Options}
{synopt :{opth by(varlist)}}stratify on {it:varlist}{p_end}
{synopt :{opt es:tandard}}combine external weights with within-stratum statistics{p_end}
{synopt :{opt is:tandard}}combine internal weights with within-stratum statistics{p_end}
{synopt :{opth s:tandard(varname)}}combine use-specified weights with within-stratum statistics{p_end}
{synopt :{opt p:ool}}display pooled estimate{p_end}
{synopt :{opt noc:rude}}do not display crude estimate{p_end}
{synopt :{opt noh:om}}do not display homogeneity test{p_end}
{synopt :{opt rd}}calculate standardized risk difference{p_end}
{synopt :{opth b:inomial(varname)}}number of subjects variable{p_end}
{synopt :{opt or}}report odds ratio{p_end}
{synopt :{opt w:oolf}}use Woolf approximation for calculating SE of the odds ratio{p_end}
{synopt :{opt tb}}calculate test-based confidence intervals{p_end}
{synopt :{opt e:xact}}calculate Fisher's exact p{p_end}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synoptline}
{p2colreset}{...}


{synoptset 21}{...}
{marker csi_options}{...}
{synopthdr :csi_options}
{synoptline}
{synopt :{opt or}}report odds ratio{p_end}
{synopt :{opt w:oolf}}use Woolf approximation for calculating SE of the odds ratio{p_end}
{synopt :{opt tb}}calculate test-based confidence intervals{p_end}
{synopt :{opt e:xact}}calculate Fisher's exact p{p_end}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synoptline}
{p2colreset}{...}

{synoptset 21 tabbed}{...}
{marker cc_options}{...}
{synopthdr:cc_options}
{synoptline}
{syntab:Options}
{synopt :{opth by(varname)}}stratify on {it:varname}{p_end}
{synopt :{opt es:tandard}}combine external weights with within-stratum statistics{p_end}
{synopt :{opt is:tandard}}combine internal weights with within-stratum statistics{p_end}
{synopt :{opth s:tandard(varname)}}combine use-specified weights with within-stratum statistics{p_end}
{synopt :{opt p:ool}}display pooled estimate{p_end}
{synopt :{opt noc:rude}}do not display crude estimate{p_end}
{synopt :{opt noh:om}}do not display homogeneity test{p_end}
{synopt :{opt bd}}perform Breslow-Day homogeneity test{p_end}
{synopt :{opth b:inomial(varname)}}number of subjects variable{p_end}
{synopt :{opt co:rnfield}}use Cornfield approximation for calculating SE of the odds ratio{p_end}
{synopt :{opt w:oolf}}use Woolf approximation for calculating SE of the odds ratio{p_end}
{synopt :{opt tb}}calculate test-based confidence intervals{p_end}
{synopt :{opt e:xact}}calculate Fisher's exact p{p_end}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synoptline}
{p2colreset}{...}

{synoptset 21}{...}
{marker cci_options}{...}
{synopthdr :cci_options}
{synoptline}
{synopt :{opt co:rnfield}}use Cornfield approximation for calculating SE of the odds ratio{p_end}
{synopt :{opt w:oolf}}use Woolf approximation for calculating SE of the odds ratio{p_end}
{synopt :{opt tb}}calculate test-based confidence intervals{p_end}
{synopt :{opt e:xact}}calculate Fisher's exact p{p_end}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synoptline}
{p2colreset}{...}

{synoptset 21 tabbed}{...}
{marker tabodds_options}{...}
{synopthdr :tabodds_options}
{synoptline}
{syntab:Main}
{synopt :{opth b:inomial(varname)}}number of subjects variable{p_end}
{synopt :{opt or}}report odds ratio{p_end}
{synopt :{opth adj:ust(varlist)}}report odds ratios adjusted for the variables in {it:varlist}{p_end}
{synopt :{opt base(#)}}reference group of control variable for odds ratio{p_end}
{synopt :{opt co:rnfield}}use Cornfield approximation for calculating SE of the odds ratio{p_end}
{synopt :{opt w:oolf}}use Woolf approximation for calculating SE of the odds ratio{p_end}
{synopt :{opt tb}}calculate test-based confidence intervals{p_end}
{synopt :{opt g:raph}}graph odds against categories{p_end}
{synopt :{opt ci:plot}}same as {opt graph} options, except include confidence intervals{p_end}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{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 ciop:ts(twoway_rcap:rcap_options)}}affect rendition of the confidence bands{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 21 tabbed}{...}
{marker mhodds_options}{...}
{synopthdr :mhodds_options}
{synoptline}
{syntab:Options}
{synopt :{opth by(varlist)}}stratify on {it:varlist}{p_end}
{synopt :{opth bi:nomial(varname)}}number of subject variables{p_end}
{synopt :{opt c:ompare(v_1, v_2)}}override categories of the control variable{p_end}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synoptline}
{p2colreset}{...}

{pstd}{opt fweight}s are allowed; see {help weight}.


{title:Description}

{pstd}
{cmd:ir} is used with incidence-rate (incidence density or person-time) data.
It calculates point estimates and confidence intervals for the incidence-rate 
ratio and difference, along with attributable or prevented fractions for the 
exposed and total population.  {cmd:iri} is the immediate form of {cmd:ir}; see
{help immed}.  Also see {helpb poisson} and {helpb stcox} for related commands.

{pstd}
{cmd:cs} is used with cohort study data with equal follow-up time per subject
and sometimes with cross-sectional data.  Risk is then the proportion of
subjects who become cases.  It calculates point estimates and confidence 
intervals for the risk difference, risk ratio, and (optionally) the odds ratio,
along with attributable or prevented fractions for the exposed and total
population.  {cmd:csi} is the immediate form of {cmd:cs}; see {help immed}.
Also see {helpb logistic} and {helpb glogit} for related commands.

{pstd}
{cmd:cc} is used with case-control and cross-sectional data.  Point estimates
and confidence intervals for the odds ratio are calculated along with
attributable or prevented fractions for the exposed and total population.
{cmd:cci} is the immediate form of {cmd:cc}; see {help immed}.  Also see
{helpb logistic} and {helpb glogit} for related commands.

{pstd}
{cmd:tabodds} is used with case-control and cross-sectional data. It
tabulates the odds of failure against a categorical explanatory variable
{it:expvar}.  If {it:expvar} is specified, {cmd:tabodds} performs an
approximate chi-squared test of homogeneity of odds and a test for linear trend
of the log odds against the numerical code used for the categories of
{it:expvar}.  Both of these tests are based on the score statistic and its
variance.  When {it:expvar} is absent, the overall odds are reported.  The
variable {it:var_case} is coded 0/1 for individual and simple frequency records
and equals the number of cases for binomial frequency records.

{pstd}
Optionally, {cmd:tabodds} will tabulate adjusted or unadjusted odds ratios
using either the lowest levels of {it:expvar} or a user-defined level as the
reference group.  If {opth adjust(varlist)} is specified, it produces odds 
ratios adjusted for the variables in {it:varlist} along with a (score) test 
for trend.

{pstd}
{cmd:mhodds} is used with case-control and cross-sectional data. It estimates
the ratio of the odds of failure for two categories of {it:expvar}, controlled
for specified confounding variables, {it:vars_adjust}, and also tests whether 
this odds ratio is equal to one.  When {it:expvar} has more than two categories
but none are specified with the {opt compare()}, {cmd:mhodds} assumes that 
{it:expvar} is a quantitative variable and calculates a one-degree-of-freedom 
test for trend.  It also calculates an approximate estimate of the rate ratio 
for a one-unit increase in {it:expvar}. This is a one-step Newton-Raphson 
approximation to the maximum likelihood estimate calculated as the ratio of 
the score statistic, {it:U}, to its variance, {it:V}.

{pstd}
{cmd:mcc} is used with matched case-control data.  It calculates McNemar's 
chi-squared; point estimates and confidence intervals for the difference, ratio,
and relative difference of the proportion with the factor; and the odds ratio.
{cmd:mcci} is the immediate form of {cmd:mcc}; see {help immed}.  Also see 
{helpb clogit} and {helpb symmetry} for related commands.


{title:Options}

{pstd}Options are listed in the order in which they appear in the syntax tables
above.  The commands for which the options is valid are indicated in parentheses
immediately following the option name.

{dlgtab:Options (ir, cs, cc, and mhodds)/Main (tabodds)}

{phang}
{opth by(varname)} ({cmd:ir}, {cmd:cs}, {cmd:cc}, and {cmd:mhodds}) specifies 
that the tables be stratified on {it:varname}.  Within-stratum statistics are 
shown then combined with Mantel-Haenszel weights.  If {opt estandard}, 
{opt istandard}, or {opt standard()} is also specified (see below), the weights
specified are used in place of Mantel-Haenszel weights.  {cmd:cs} and 
{cmd:mhodds} will accept a {it:varlist}.

{phang}
{opt estandard}, {opt istandard}, and {opth standard(varname)} ({cmd:ir}, 
{cmd:cs}, and {cmd:cc}) request that within-stratum statistics be combined with 
external, internal, or user-specified weights to produce a standardized 
estimate.  These options are mutually exclusive and can be used only when 
{opt by()} is also specified.  (When {opt by()} is specified without one of 
these options, Mantel-Haenszel weights are used.)

{pmore}
{opt estandard} external weights are the person-time for the unexposed
({cmd:ir}), the total number of unexposed ({cmd:cs}), or the number of
unexposed controls ({cmd:cc}).

{pmore}
{cmd:istandard} internal weights are the person-time for the exposed
({cmd:ir}), the total number of exposed ({cmd:cs}), or the number of exposed
controls ({cmd:cc}).  {opt istandard} can be used to produce, among other 
things, standardized mortality ratios (SMRs).

{pmore}
{opt standard(varname)} allows user-specified weights.  {it:varname} 
must contain a constant within stratum and be non-negative.  The scale of 
{it:varname} is irrelevant.

{phang}
{opt pool} ({cmd:ir}, {cmd:cs}, and {cmd:cc}) specifies that, in a stratified 
analysis, the directly pooled estimate also be displayed.  The pooled estimate 
is a weighted average of the stratum-specific estimates using inverse-variance 
weights, which are the inverse of the variance of the stratum-specific estimate.
{opt pool} is relevant only if {opt by()} is also specified.

{phang}
{opt nocrude} ({cmd:ir}, {cmd:cs}, and {cmd:cc}) specifies that in a stratified
analysis the crude estimate{hline 2}an estimate obtained without regard to 
strata{hline 2}not be displayed.  {opt nocrude} is relevant only if {opt by()} 
is also specified.

{phang}
{opt nohom} ({cmd:ir}, {cmd:cs}, and {cmd:cc}) specifies that a chi-squared 
test of homogeneity not be included in the output of a stratified analysis.  
This tests whether the exposure effect is the same across strata and can be 
performed for any pooled estimate{hline 2}directly pooled or Mantel-Haenszel.  
{opt nohom} is relevant only if {opt by()} is also specified.

{phang}