_svy_setup.hlp

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

{smcl}
{* 10mar2005}{...}
{cmd:help _svy_setup}{...}
{right:also see:  {help undocumented}}
{hline}

{title:Title}

{p 4 20 2}
{hi:_svy_setup} {hline 2} Retrieve svy settings and adjust weights


{title:Syntax}

{phang2}
{cmd:_svy_setup}
	{it:markvar}
	{it:submarkvar}
	{weight}
	[{cmd:,}
		{opt cmdname(name)} 
		{opt sub:pop(subpop, ...)} 
		{opt srs:subpop} 
		{opt over(varlist)} 
		{opt nosubdrop}
	]

{pstd}
{it:weights} are not allowed, but are indicated above for the purpose of
generating an informative error message for the calling routine.


{title:Description}

{pstd}
{cmd:_svy_setup} is a programmers' tool for retrieving the required
information for survey data analysis.  {cmd:_svy_setup} will display an error
message if the data are not currently {cmd:svyset}.

{phang}
{it:markvar} is a mark variable as described in {helpb mark}.  This variable
identifies the subset of the data that will be used for estimation purposes.

{phang}
{it:submarkvar} is a new variable name and will identify the subpopulation
observations defined by {it:markvar} and the {opt subpop()} and {opt over()}
options.


{title:Options}

{phang}
{opt cmdname(name)} identifies the name of the calling routine, and is used to
identify commands that allow the {opt over()} option.

{phang}
{opt subpop(subpop, ...)} identifies the subpopulation; see {helpb svy}.

{phang}
{opt srssubpop} is sometimes allowed outside the {opt subpop()} option; see
{helpb svy}.

{phang}
{opt over(varlist)} identifies multiple subpopulations.
This option along with the {opt cmdname()} option help provide better error
messages for syntax errors in specifying subpopulations.

{phang}
{opt nosubdrop} prevents observations from being dropped from the estimation
sample when they belong to a stratum that does not overlap within the
specified subpopulation.


{title:Examples}

{pstd}
{cmd:. _svy_setup touse subuse wvar, cmdname(mean)}
{p_end}


{title:Saved results}

{phang}
{cmd:_svy_setup} saves in {cmd:r()}.  The following items are added to the
saved results from {cmd:svyset}:

{p2colset 9 25 32 2}{...}
{phang}
Scalars:

{p2col :{cmd:r(N)}}the number of selected observations{p_end}
{p2col :{cmd:r(N_pop)}}the population size{p_end}
{p2col :{cmd:r(N_strata)}}the number of strata{p_end}
{p2col :{cmd:r(N_psu)}}the number of PSUs{p_end}
{p2col :{cmd:r(N_sub)}}the number of selected subpopulation observations{p_end}
{p2col :{cmd:r(N_subpop)}}the subpopulation size{p_end}
{p2col :{cmd:r(N_subpsu)}}the subpopulation PSUs{p_end}

{phang}
Macros:

{p2col :{cmd:r(subpop)}}the parsed {opt subpop()} option{p_end}
{p2col :{cmd:r(srssubpop)}}the parsed {opt srssubpop} option{p_end}


{title:Also see}

{psee}
Online:
{helpb svy},
{helpb svyset}
{p_end}