{smcl} {hline} help for {hi:hcnbreg} {right:(Joseph Hilbe)} {hline} {title:Heterogeneous canonical negative binomial regression} {p 8 13 2}{cmd:hcnbreg}{space 2}{it:depvar} [{it:varlist}] [{cmd:if} {it:exp}] [{cmd:in} {it:range}] [, {cmdab:lna:lpha(}{it:varlist}{cmd:)} {cmdab:off:set(}{it:varname}{cmd:)} {cmdab:exp:osure(}{it:varname}{cmd:)} {cmdab:cl:uster(}{it:varname}{cmd:)} {cmdab:l:evel(}{it:#}{cmd:)} {cmdab:from:(}{it:asis}{cmd:)} {cmdab:ir:r} {cmdab:eform} {cmdab:rob:ust} {cmd:nolog} {it:maximize_options} {it:survey_options}] {p 4 4 2} {cmd:aweight}s, {cmd:fweight}s, {cmd:iweight}s, and {cmd:pweight}s are allowed; see help {help weights}. {p 4 4 2} {cmd:hcnbreg} provides access to all {it:maximize} options; see help {help maximize}. {p 4 4 2} {cmd:hcnbreg} provides access to all {it:survey} options; see help {help svy}. {title:Description} {p 4 4 2}{cmd:hcnbreg} fits a maximum-likelihood negative binomial regression model, with a heterogeneous (Stata: -generalized-) canonical parameterization, of {it:depvar} on {it:indepvars}, where {it:depvar} is a non-negative count variable. {p 4 4 2}{cmd:hcnbreg} acccepts all of the {it:help maximize} options, the {it:constraint()} option, and all survey options and capabilities documented in {cmd:[SVY]}; including multi-level surveys; poststratification; and BRR, jackknife, and linearization VCE estimators. {p 4 4 2}The {cmd:lnalpha}() option parameterizes the natural log of alpha, the negative binomial heterogeniety or ancillary parameter. When parameterized, the displayed value of alpha is the exponential of the parameterized constant, and has little value for understanding predictor contributions to the parameter. {p 4 4 2}This program uses {cmd:ml lf} method. {title:Options} {dlgtab:Model} {phang} {opth lnalpha(varlist)} in which ancillary parameter alpha is parameterized by listed variables. {phang} {opth offset(varname)} specifies a {it:varname} in model with coefficient constrained to 1. {phang} {opth exposure(varname)} specifies a {it:ln(varname)} in model with coefficient constrained to 1. {phang} {opth constraints(constraints)} apply specified linear constraints. {dlgtab:SE/Robust} {phang} {opth cluster(varname)} {p 4 8 2} {cmd:robust} specifies that the Huber/White/sandwich estimator of variance is to be used in place of the traditional calculation. {cmd:robust} combined with {cmd:cluster}{cmd:(}{cmd:)} allows observations which are not independent within cluster (although they must be independent between clusters). If you specify {cmd:pweight}s, {cmd:robust} is implied. {phang} {opth vce(options)} allowed. {cmd:vce}{cmd:(}{cmd:)} supports {it:robust}, {it:opg}, and {it:native}. {cmd:vce} does not support options {it:bootstrap} or {it:jacknife}, However, {cmd:cnbreg} does support the {cmd:bootstrap} and {cmd:jacknife} commands, so these modeling capabilities are allowed. {dlgtab:Reporting} {p 4 8 2}{cmd:level(}{it:#}{cmd:)} specifies the confidence level, in percent, for confidence intervals of the coefficients; see help {help level}. {p 4 8 2} {cmd:nolog} suppresses the iteration log. {dlgtab:max options} {phang} {p 4 8 2} {it:maximize_options}: technique(algorithm_spec), [no]log, trace, hessian, gradient, showstep, shownrtolerance, difficult, iterate(#), tolerance(#), ltolerance(#), gtolerance(#), nrtolerance(#), nonrtolerance, from(init_specs); see {help maximize}. {dlgtab:svy options} {phang} {it:survey_options} are all available. See help {help svy} {title:Author and support} {phang} {cmd: Joseph Hilbe}, {cmd: Arizona State University}: {cmd: Hilbe@asu.edu} {title:Remarks} {pstd} {cmd:hcnbreg} is a user authored program. Support is by author. {cmd:NOTE}: The canonical parameterization of the negative binomial derives directly from the exponential family form negative binomial probability function; not a Poisson-gamma mixture model. Unlike NB-1 and NB-2, the heterogeniety or ancillary parameter is a term of the mean and variance functions. {pstd} {cmd:hcnbreg} requires a nonnegative response. {title:Examples} {phang}{cmd:. hcnbreg los hmo white type2 type3, nolog irr} {phang}{cmd:. hcnbreg los hmo white type2 type3, nolog lnalpha(hmo white)} {phang}{cmd:. hcnbreg los hmo white type2 type3, nolog exposure(pop) cluster(state)} {phang}{cmd:. bootstrap: hcnbreg los hmo white type2 type3, nolog lnalpha(hmo white) eform} {title:Reference} {phang} Hilbe, J. (2007), {it:Negative Binomial Regression}, Cambridge, UK: Cambridge University Press. {phang} Hardin, J. & J. Hilbe (2007), {it:Generalized Linear Models and Extensions}, 2nd ed., Stata Press. {title:Also see} {psee} Online: {helpb help} {helpb gnbreg}