xtnbreg.hlp

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

{smcl}
{* 07apr2005}{...}
{cmd:help xtnbreg} {right:dialog:  {bf:{dialog xtnbreg}}{space 15}}
{right:also see:  {help xtnbreg postestimation}}
{hline}

{title:Title}

{p2colset 5 21 23 2}{...}
{p2col :{hi:[XT] xtnbreg} {hline 2}}Fixed-effects, random-effects, & population-averaged negative binomial models{p_end}
{p2colreset}{...}


{title:Syntax}

{phang}
Random-effects (RE) and conditional fixed-effects (FE) overdispersion models

{p 8 16 2}
{cmd:xtnbreg} {depvar} [{indepvars}] {ifin} {weight} [{cmd:,}
[{opt re}|{opt fe}] {it:{help xtnbreg##reandfeopts:RE/FE_options}}]

{phang}
Population-averaged (PA) model

{p 8 16 2}
{cmd:xtnbreg} {depvar} [{indepvars}] {ifin} {weight} {cmd:,}
{opt pa} [{it:{help xtnbreg##paopts:PA_options}}]

{marker reandfeopts}{...}
{synoptset 27 tabbed}{...}
{synopthdr:RE/FE_options}
{synoptline}
{syntab :Model}
{synopt :{opth "i(varname:varname_i)"}}use {it:varname_i} as the panel ID variable{p_end}
{synopt :{opt nocon:stant}}suppress constant term; not available with {opt fe}{p_end}
{synopt :{opt re}}use random-effects estimator; the default{p_end}
{synopt :{opt fe}}use fixed-effects estimator{p_end}
{synopt :{opth exp:osure(varname)}}include ln({it:varname}) in model with coefficient constrained to 1{p_end}
{synopt :{opth off:set(varname)}}include {it:varname} in model with coefficient constrained to 1{p_end}
{synopt :{opth const:raints(estimation options##constraints():constraints)}}apply specified linear constraints{p_end}

{syntab :SE}
{synopt :{opth vce(vcetype)}}{it:vcetype} may be {opt boot:strap} or {opt jack:knife}{p_end}

{syntab :Reporting}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synopt :{opt ir:r}}report incidence-rate ratios{p_end}
{synopt :{opt noskip}}perform likelihood-ratio test{p_end}

{syntab :Max options}
{synopt :{it:{help xtnbreg##maximize_options:maximize_options}}}control the maximization process; seldom used{p_end}
{synoptline}
{p2colreset}{...}

{marker paopts}{...}
{synoptset 27 tabbed}{...}
{synopthdr:PA_options}
{synoptline}
{syntab :Model}
{synopt :{opth "i(varname:varname_i)"}}use {it:varname_i} as the panel ID variable{p_end}
{synopt :{opt nocon:stant}}suppress constant term{p_end}
{synopt :{opt pa}}use population-averaged estimator{p_end}
{synopt :{opth exp:osure(varname)}}include ln({it:varname}) in model with coefficient constrained to 1{p_end}
{synopt :{opth off:set(varname)}}include {it:varname} in model with coefficient constrained to 1{p_end}

{syntab :PA options}
{synopt :{cmdab:c:orr(}{it:{help xtnbreg##correlation:correlation}}{cmd:)}}within-group correlation structure{p_end}
{synopt :{opt force}}estimate even if observations unequally spaced in time{p_end}

{syntab :SE/Robust}
{synopt :{opth vce(vcetype)}}{it:vcetype} may be {opt r:obust}, {opt boot:strap}, or {opt jack:knife}{p_end}
{synopt :{opt r:obust}}synonym for {cmd:vce(robust)}{p_end}
{synopt :{opt nmp}}use divisor N-P instead of the default N{p_end}
{synopt :{cmdab:s:cale(x2)}}set scale parameter to Pearson chi-squared statistic{p_end}
{synopt :{cmdab:s:cale(dev)}}set scale parameter to deviance divided by degrees of freedom{p_end}
{synopt :{cmdab:s:cale(phi)}}do not rescale the variance{p_end}
{synopt :{opt scale(#)}}set scale parameter to {it:#}{p_end}

{syntab :Reporting}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synopt :{opt irr}}report incidence-rate ratios{p_end}

{syntab :Opt options}
{synopt :{it:{help xtnbreg##optimize_options:optimize_options}}}control the optimization process; seldom used{p_end}
{synoptline}
{p2colreset}{...}

{synoptset 23}{...}
{marker correlation}{...}
{synopthdr :correlation}
{synoptline}
{synopt :{opt exc:hangeable}}exchangeable{p_end}
{synopt :{opt ind:ependent}}exchangeable{p_end}
{synopt :{opt uns:tructured}}unstructured{p_end}
{synopt :{opt fix:ed} {it:matname}}user-specified{p_end}
{synopt :{opt ar} {it:#}}autoregressive of order {it:#}{p_end}
{synopt :{opt sta:tionary} {it:#}}stationary of order {it:#}{p_end}
{synopt :{opt non:stationary} {it:#}}nonstationary of order {it:#}{p_end}
{synoptline}
{p2colreset}{...}

{p 4 6 2}
{it:depvar} and {it:indepvars} may contain time-series operators;
see {help tsvarlist}.{p_end}
{p 4 6 2}
{opt bootstrap}, {opt by}, {opt jackknife}, {opt statsby}, and {opt xi} may be used with {cmd:xtnbreg}; see {help prefix}.{p_end}
{p 4 6 2}
{opt iweight}s, {opt fweight}s, and {opt pweight}s are allowed for the population-averaged model, and {opt iweight}s are allowed in the random-effects and fixed-effects models; see {help weight}.  Weights must be constant within panels.{p_end}
{p 4 6 2}
See {help xtnbreg postestimation} for features available after estimation.{p_end}


{title:Description}

{pstd}
{cmd:xtnbreg} fits random-effects overdispersion models, conditional
fixed-effects overdispersion models, and population-averaged negative binomial
models.  Here "random effects" and "fixed effects" apply to the distribution
of the dispersion parameter, not to the xb term in the model.  In the
random-effects and fixed-effects overdispersion models, the dispersion is the
same for all elements in the same group (i.e., elements with the same value of
the {opt i()} variable).  In the random-effects model, the dispersion varies
randomly from group to group, such that the inverse of one plus the dispersion
follows a b[r,s] distribution.  In the fixed-effects model, the dispersion
parameter in a group can take on any value, since a conditional likelihood is
used in which the dispersion parameter drops out of the estimation.

{pstd}
By default, the population-averaged model is an equal-correlation model;
{cmd:xtnbreg} assumes {cmd:corr(exchangeable)}.  See {helpb xtgee} for details
on fitting other population-averaged models.


{title:Options for RE/FE models}

{dlgtab:Model}

{phang}
{opth "i(varname:varname_i)"}, {opt noconstant}; see
    {help estimation options##i():estimation options}.

{phang}
{opt re} requests the random-effects estimator, which is the default.

{phang}
{opt fe} requests the conditional fixed-effects estimator.

{phang}
{opth exposure(varname)}, {opth offset(varname)},
 {opt constraints(constraints)}; see {help estimation options}.

{dlgtab:SE}

{phang}
{opt vce(vcetype)}; see {it:{help vce_option}}.

{dlgtab:Reporting}

{phang}
{opt level(#)}; see {help estimation options##level():estimation options}. 

{phang}
{opt irr} reports exponentiated coefficients e^b rather than b.  For the
negative binomial model, exponentiated coefficients have the interpretation of
incidence-rate ratios.

{phang}
{opt noskip}; see {help estimation options##noskip:estimation options}. 

{dlgtab:Max options}

{phang}
{marker maximize_options}
{it:maximize_options}: {opt dif:ficult}, {opt tech:nique(algorithm_spec)}, 
{opt iter:ate(#)}, [{opt no:}]{opt lo:g}, {opt tr:ace}, {opt grad:ient}, 
{opt showstep}, {opt hess:ian}, {opt shownr:tolerance}, {opt tol:erance(#)}, 
{opt ltol:erance(#)}, {opt gtol:erance(#)}, {opt nrtol:erance(#)}, 
{opt nonrtol:erance}, {opt from(init_specs)}; see {helpb ml} and 
{help maximize}.  These options are seldom used.


{title:Options for PA model}

{dlgtab:Model}

{phang}
{opth "i(varname:varname_i)"}, {opt noconstant}; see
   {help estimation options##i():estimation options}.

{phang}
{opt pa} requests the population-averaged estimator.

{phang}
{opth exposure(varname)}, {opth offset(varname)}; see
        {help estimation options##exposure():estimation options}.

{dlgtab:PA Options}

{phang}
{opt corr(correlation)}, {opt force}; see
 {help estimation options##corr():estimation options}.

{dlgtab:SE/Robust}

{phang}
{opt vce(vcetype)}; see {it:{help vce_option}}.

{phang}
{opt robust}, {opt nmp}; see {help estimation options##robust:estimation options}.

{phang}
{cmd:scale(x2}|{cmd:dev}|{it:#}|{cmd:phi)} overrides the default scale
parameter of {cmd:scale(1)}; see
 {help estimation options##scale():estimation options}.

{dlgtab:Reporting} 

{phang}
{opt level(#)}; see {help estimation options##level():estimation options}.

{phang}
{opt irr} reports exponentiated coefficients e^b rather than b.  For the
negative binomial model, exponentiated coefficients have the interpretation of
incidence-rate ratios.

{dlgtab:Opt options}

{phang}
{marker optimize_options}
{it:optimize_options} control the iterative optimization process.  These options
are seldom used.

{pmore}
{opt iter:ate(#)} specifies the maximum number of iterations.  When the number 
of iterations equals #, the optimization stops and presents the current results,
even if the convergence tolerance has not been reached.  The default value of 
{opt iterate()} is 100.

{pmore}
{opt tol:erance(#)} specifies the tolerance for the coefficient vector.  When 
the relative change in the coefficient vector from one iteration to the next is
less than or equal to #, the optimization process is stopped.  
{cmd:tolerance(1e-6)} is the default.

{pmore}
{opt nolog} suppress the display of the iteration log.

{pmore}
{opt tr:ace} specifies that the current estimates should be printed at each
iteration.


{title:Examples}

{phang}{cmd:. xtnbreg y x, i(id)}

{phang}{cmd:. xtnbreg y x, i(id) fe}

{phang}{cmd:. xtnbreg y x, i(id) pa robust}


{title:Also see}

{psee}
Manual:  {bf:[XT] xtnbreg}

{psee}
Online:  {help xtnbreg postestimation};{break}
{help xt}; {helpb nbreg}, 
{helpb xtdata}, {helpb xtdes}, {helpb xtgee}, {helpb xtpoisson}, {helpb xtsum},
{helpb xttab}
{p_end}