svy_brr.hlp

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

{smcl}
{* 29mar2005}{...}
{cmd:help svy brr}{...}
{right:dialog:  {bf:{dialog svy_brr}}{space 11}}
{right:also see:  {help svy postestimation}}
{hline}

{title:Title}

{p2colset 5 22 26 2}{...}
{p2col :{hi:[SVY] svy brr} {hline 2}}Balanced repeated replication{p_end}
{p2colreset}{...}


{title:Syntax}

{p 8 15 2}
[{cmd:svy}] {cmd:brr}
	{it:{help exp_list}}
	[{cmd:,}
		{it:svy_options}
		{it:brr_options}
	]
	{cmd::} {it:command}


{synoptset 25 tabbed}{...}
{synopthdr:svy_options}
{synoptline}
{syntab:if/in}
{synopt :{opt sub:pop()}}identify a subpopulation{p_end}

{syntab:Reporting}
{synopt :{opt l:evel(#)}}set confidence level; default is {cmd:level(95)}{p_end}
{synopt :{opt noh:eader}}suppress the table header{p_end}
{synopt :{opt nol:egend}}suppress the table legend{p_end}
{synopt :{opt noadj:ust}}do not adjust model Wald statistic{p_end}
{synoptline}

{synopthdr:brr_options}
{synoptline}
{syntab:Main}
{synopt :{opt h:adamard(matrix)}}Hadamard matrix{p_end}
{synopt :{opt fay(#)}}Fay's adjustment{p_end}

{syntab:Options}
{synopt :{help prefix_saving_option:{bf:saving(}{it:filename}{bf:, ...)}}}save
	results to {it:filename}; save statistics in double precision; save
	results to {it:filename} every {it:#} replications{p_end}
{synopt :{opt mse}}use MSE formula for variance estimate{p_end}

{syntab:Reporting}
{synopt :{opt v:erbose}}display the full table legend{p_end}
{synopt :{opt nodots}}suppress the replication dots{p_end}
{synopt :{opt noi:sily}}display any output from {it:command}{p_end}
{synopt :{opt tr:ace}}trace the {it:command}{p_end}
{synopt :{opt ti:tle(text)}}use {it:text} as title for BRR results{p_end}

{syntab:Advanced}
{synopt :{opt nodrop}}do not drop observations{p_end}
{synopt :{opt reject(exp)}}identify invalid results{p_end}
{synoptline}
{p2colreset}{...}
{pstd}
{opt weights} are not allowed in {it:command}.
{p_end}
INCLUDE help svy_notes_common


{title:Description}

{pstd}
{cmd:svy} {cmd:brr} performs balanced repeated replication (BRR) for complex
survey data.  Typing

{pin}
{cmd:. svy brr} {it:exp_list} {cmd::} {it:command}

{pstd}
executes {it:command} once for each replicate, using sampling weights that are
adjusted according to the BRR methodology.

{phang}
{it:command} defines the statistical command to be executed.
Most Stata commands and user-written programs can be used with
{cmd:svy} {cmd:brr},
as long as they follow {help language:standard Stata syntax},
allow the {it:{help if}} qualifier,
and allow {cmd:pweight}s and {cmd:iweight}s; see {help weights}.
The {cmd:by} prefix is not allowed to be part of {it:command}.

{phang}
{it:{help exp_list}} specifies the statistics to be collected from the
execution of {it:command}.
{it:exp_list} is required unless {it:command} has the {cmd:svyb} program
property, in which case {it:exp_list} defaults to {cmd:_b}; see
{help program properties}.


{title:Options}

{phang}
{it:svy_options}; see {helpb svy}.

{dlgtab:Main}

{phang}
{opt hadamard(matrix)} specifies the Hadamard matrix to be used to determine
which PSUs are chosen for each replicate.

{phang}
{opt fay(#)} specifies Fay's adjustment.
The sampling weight of the selected PSUs for a given replicate are multiplied
by {hi:2-}{it:#},
where the sampling weight for the unselected PSUs are multiplied by {it:#}.
{cmd:fay(0)} is the default, and is equivalent to the original BRR method.

{pmore}
{it:#} must be a number between 0 and 2; however, {cmd:fay(1)} is not allowed.

{dlgtab:Options}

INCLUDE help prefix_saving_option

{pmore}
See {it:{help prefix_saving_option}}, for details about {it:suboptions}.

{phang}
{opt mse} indicates that {cmd:svy} {cmd:brr} compute the variance using
deviations of the replicates from the observed value of the statistics based
on the entire dataset.  By default, {cmd:svy} {cmd:brr} computes the variance
using deviations from the average of the replicates.

{dlgtab:Reporting}

{phang}
{opt verbose} requests that the full table legend be displayed.  By default,
coefficients and standard errors are not displayed.

{phang}
{opt nodots} suppresses the replication dots from being displayed.  By
default, a single dot character is printed for each successful replication;
however, a single red `x' is printed if {it:command} returns with an error, or
one of the values in {it:exp_list} is missing.

{phang}
{opt noisily} requests that any output from {it:command} be displayed.
This option implies the {opt nodots} option.

{phang}
{opt trace} causes a trace of the execution of {it:command} to be displayed.
This option implies the {opt noisily} option.

{phang}
{opt title(text)} specifies a title to be displayed above the
table of BRR results; the deafult title is "BRR results".

{dlgtab:Advanced}

{phang}
{opt nodrop} prevents observations outside {cmd:e(sample)} and the
{it:if} and {it:in} options from being dropped.

{phang}
{opt reject(exp)} identifies an expression that indicates when results should
be rejected.  When {it:exp} is true, the resulting values are reset to missing
values.


{title:Examples}

{phang}
{cmd:. webuse nhanes2brr}
{p_end}
{phang}
{cmd:. svyset}
{p_end}
{phang}
{cmd:. svy brr WtoH = (_b[weight]/_b[height]) : total weight height}
{p_end}
{phang}
{cmd:. svy brr WtoH = (_b[weight]/_b[height]), mse : total weight height}
{p_end}

{phang}
{cmd:. webuse nhanes2}
{p_end}
{phang}
{cmd:. svy brr, hadamard(h32) : ratio (WtoH: weight/height)}
{p_end}


{title:Also see}

{psee}
Manual:  {bf:[SVY] svy brr}

{psee}
Online:  {help svy postestimation};{break}
{helpb svy jackknife}
{p_end}