svy.hlp

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

{smcl}
{* 30mar2005}{...}
{cmd:help svy}{...}
{right:also see:  {help "svy postestimation"}}
{hline}

{title:Title}

{pstd}
{hi:[SVY] svy} {hline 2} The survey prefix command


{title:Syntax}

{phang2}
{cmd:svy} [{it:vcetype}] [{cmd:,} {it: svy_options}] {cmd::} {it:command}


{synoptset 21 tabbed}{...}
{* NOTE:  Also see svy_optable.ihlp, svy_brr.hlp and svy_jknife.hlp if you are}
{* going to change the contents of this table.}
{synopthdr:vcetype}
{synoptline}
{syntab:SE}
{synopt :{opt linear:ized}}Taylor linearized variance estimation{p_end}
{synopt :{opt brr}}BRR variance estimation; see {helpb svy brr}{p_end}
{synopt :{opt jack:knife}}jackknife variance estimation;
	see {helpb svy jackknife}{p_end}
{synoptline}
{p 4 6 2}
Specifying a {it:vcetype} overrides the default from {cmd:svyset}.


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

{syntab:SE}
{synopt :{it:{help brr_options}}}additional
	options allowed with BRR variance estimation{p_end}
{synopt :{it:{help jackknife_options}}}additional
	options allowed with jackknife variance estimation{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}

{p2coldent:+ {opt noi:sily}}display results from {it:command}{p_end}
{p2coldent:+ {opt tr:ace}}trace the {it:command}{p_end}
{synoptline}
{p 4 6 2}
+ {opt noisily} and {opt trace} are not shown in the dialog boxes for
estimation commands.
{p_end}
INCLUDE help svy_notes_common
{p2colreset}{...}


{title:Description}

{pstd}
{cmd:svy} fits statistical models for complex survey data.  Typing

{pmore}
{cmd:. svy:} {it:command}

{pstd}
executes {it:command} while accounting for the survey settings identified by
{cmd:svyset}.

{phang}
{it:command} defines the estimation command to be executed.  Not all
estimation commands are supported by {cmd:svy}.  See {help survey} for a
list of Stat's estimation command that are supported by {cmd:svy}.  See
{help program properties} for a discussion of what is required for {cmd:svy}
to support an estimation command.


{title:Options}

{dlgtab:if/in}

{phang}
{opt subpop}{cmd:(}{it:subpop}{cmd:)} specifies that
estimates be computed for the single subpopulation identified by
{it:subpop}, which is

{pmore2}
[{varname}] [{it:{help if}}]

{pmore}
Thus the subpopulation is defined by the observations for which
{it:varname}!=0 that also meet the {it:if} conditions.  Typically,
{it:varname}==1 defines the subpopulation and {it:varname}==0 indicates
observations not belonging to the subpopulation.  For observations whose
subpopulation status is uncertain, {it:varname} should be set to a missing
value; such observations are dropped from the estimation sample.

{dlgtab:SE}

{phang}
{it:{help brr_options}} are additional options that are allowed with BRR
variance estimation specified by {cmd:svy} {cmd:brr} or as {cmd:svyset} using
the {cmd:vce(brr)} option.

{phang}
{it:{help jackknife_options}} are additional options that are allowed with
jackknife variance estimation specified by {cmd:svy} {cmd:jackknife} or as
{cmd:svyset} using the {cmd:vce(jackknife)} option.


{dlgtab:Reporting}

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

{phang}
{opt noheader} prevents the table header from being displayed.

{phang}
{opt nolegend} prevents the table legend identifying the subpopulations from
being displayed.

{phang}
{opt noadjust} specifies that the model Wald test be carried out as
{it:W}/{it:k} distributed {it:F}({it:k},{it:d}), where {it:W} is the Wald test
statistic, {it:k} is the number of terms in the model excluding the constant,
{it:d} = total number of sampled PSUs minus total number of strata, and
{it:F}({it:k},{it:d}) is an {it:F} distribution with {it:k} numerator degrees
of freedom and {it:d} denomintor degrees of freedom.  By default, an adjusted
Wald test is conducted:  ({it:d}-{it:k}+1){it:W}/({it:k}{it:d}) distributed
{it:F}({it:k},{it:d}-{it:k}+{it:1}).

{pmore}
Use of the {opt noadjust} option is not recommended.
{p_end}


{pstd}
The following option is usually available with {cmd:svy} for replaying
estimation results but is not shown on all dialog boxes:

{phang}
{it:eform_option}; see {it:{help eform_option}}.

{pstd}
The following options are available with {cmd:svy} 
but are not shown on the dialog boxes:

{phang}
{opt noisily} requests that any output from {it:command} be displayed.

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


{title:Examples}

{phang}
{cmd:. webuse nhanes2f}
{p_end}
{phang}
{cmd:. svyset psuid [pweight=finalwgt], strata(stratid)}
{p_end}
{phang}
{cmd:. svy: mean zinc}
{p_end}
{phang}
{cmd:. mean zinc}
{p_end}

{phang}
{cmd:. svyset [pweight=finalwgt]}
{p_end}
{phang}
{cmd:. svy: mean zinc}
{p_end}

{phang}
{cmd:. svyset psuid [pweight=finalwgt]}
{p_end}
{phang}
{cmd:. svy: mean zinc}
{p_end}

{phang}
{cmd:. svyset psuid [pweight=finalwgt], strata(stratid)}
{p_end}
{phang}
{cmd:. svy: regress zinc age age2 weight female black orace rural}
{p_end}
{phang}
{cmd:. regress zinc age age2 weight female black orace rural}
{p_end}


{title:Also see}

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

{psee}
Online:  {help svy postestimation};{break}
{help program properties},
{helpb _robust},
{helpb svy brr},
{helpb svy jackknife},
{helpb svyset}
{p_end}