------------------------------------------------------------------------------- help forsvrest-------------------------------------------------------------------------------

Replication-based estimates of covariances for complex survey data

svrest"command""exp_list"[ifexp] [inrange] [,[matrices(list)noisilyorliststatsdiparm(eq type name[ci] [ \ ...])]

Description

svrestruns the user-specifiedcommand, and calculates covariance estimates for the statistics specified inexp_list, using replication methods for complex survey data.svrestis based on bs.The expressions in

exp_listmust be separated by spaces and there must be no spaces within each expression. Note thatcommandandexp_listmust both be enclosed in double quotes.See survwgt and svr for details on these replication methods.

svrestestimates the statistics jointly, so it calculates both the variances of each statistic, and the covariances among them. The results are stored as estimates.See svresttest for testing hypotheses involving the estimated statistics generated by this command.

Options

matricesindicates one entire matrices of results to be included. This allows the easy display of the entire coefficient vector when usingsvrestfor an estimation command not supported by brrmodel. For example, the following would compute replication-based standard errors for the full coefficient vector from a heckman model:. svrest "heckman income age race weight, select(education)" , mat(e(b))

Important note:It is vital that the estimation in each replicate produce the same coefficient vector. Thus, for example, when runningmlogit, be sure to include thebase()option, so that the same category is omitted from the estimation for every replicate.

dotsrequests a dot be placed on the screen at the beginning of each replication, thus providing entertainment of a sort when long, slow commands are run.

noisilyrequests that output from each replication be displayed.

orrequests that statistics be displayed as odds ratios.

liststatsrequests that a key be displayed, indicating what each statistic is.

diparmrequests that single equation statistics be redisplayed in the natural metric. You must indicate the name of the equation containing the statistic, the type of transformation, the name for the statistic, and, optionally,cito indicate that the confidence interval should be appropriately transformed. When specified, this option simply calls _diparm to redisplay statistics that are not estimated in their natural metric. For example, forheckman, you might do the follwowing:. svrest "heckman income age, select(educ)" , mat(e(b)) diparm(athrho exp rho ci \ lnsigma exp sigma di)

Examples. svrest "reg mpg weight foreign" "_b[weight] _b[foreign]"

. svrest "kappa cat1-cat3" "r(z)"

AcknowledgementsI would like to thank members of the Stata technical team, whose suggestions led to the creation of this command.

AuthorNick Winter Cornell University nw53@cornell.edu