help svy: tabulate oneway dialog: svy: tabulate oneway
also see: svy postestimation
svy: tabulate twoway
-------------------------------------------------------------------------------
Title
[SVY] svy: tabulate oneway -- One-way tables for survey data
Syntax
Basic syntax
svy: tabulate varname
Full syntax
svy [vcetype] [, svy_options] : tabulate varname [if] [in] [,
tabulate_options display_items display_options]
Syntax to replay results
svy [, display_items display_options]
vcetype description
-------------------------------------------------------------------------
SE
linearized Taylor linearized variance estimation
brr BRR variance estimation; see [SVY] svy brr
jackknife jackknife variance estimation; see [SVY] svy
jackknife
-------------------------------------------------------------------------
Specifying a vcetype overrides the default from svyset.
svy_options description
-------------------------------------------------------------------------
if/in
subpop([varname] [if]) identify a subpopulation
SE
brr_options more options allowed with BRR variance
estimation
jackknife_options more options allowed with jackknife variance
estimation
-------------------------------------------------------------------------
svy requires that the survey design variables be identified using svyset;
see [SVY] svyset.
See [SVY] svy postestimation for features available after estimation.
Warning: using if or in restrictions will often not produce correct
variance estimates for subpopulations. To compute estimates for
subpopulations, use the subpop() option.
tabulate_options description
-------------------------------------------------------------------------
Model
stdize(varname) variable identifying strata for standardization
stdweight(varname) weight variable for standardization
tab(varname) variable for which to compute cell
totals/proportions
missing treat missing values like other values
-------------------------------------------------------------------------
display_items description
-------------------------------------------------------------------------
Table items
cell cell proportions
count weighted cell counts
se standard errors
ci confidence intervals
deff display the DEFF design effects
deft display the DEFT design effects
srssubpop report design effects assuming SRS within
subpopulation
obs cell observations
-------------------------------------------------------------------------
When any of se, ci, deff, deft, or srssubpop is specified, only of one
cell or count can be specified. If none of se, ci, deff, deft, or
srssubpop is specified, both cell and count can be specified.
display_options description
-------------------------------------------------------------------------
Reporting
level(#) set confidence level; default is level(95)
+ proportion display proportions; the default
percent display percentages instead of proportions
nomarginal suppress column marginal
nolabel suppress displaying value labels
cellwidth(#) cell width
csepwidth(#) column-separation width
stubwidth(#) stub width
format(%fmt) cell format; default is format(%6.0g)
-------------------------------------------------------------------------
+ proportion is not shown in the dialog box.
Menu
Statistics > Survey data analysis > Tables > One-way tables
Description
svy: tabulate produces one-way tabulations for complex survey data. See
[SVY] svy: tabulate twoway for two-way tabulations for complex survey
data.
Options
svy_options; see [SVY] svy.
+-------+
----+ Model +------------------------------------------------------------
stdize(varname) specifies that the point estimates be adjusted by direct
standardization across the strata identified by varname. This option
requires the stdweight() option.
stdweight(varname) specifies the weight variable associated with the
standard strata identified in the stdize() option. The
standardization weights must be constant within the standard strata.
tab(varname) specifies that counts be cell totals of this variable and
proportions (or percentages) be relative to (i.e., weighted by) this
variable. For example, if this variable denotes income, then the
cell "counts" are instead totals of income for each cell, and the
cell proportions are proportions of income for each cell.
missing specifies that missing values of varname be treated as another
row category rather than be omitted from the analysis (the default).
+-------------+
----+ Table items +------------------------------------------------------
cell requests that cell proportions (or percentages) be displayed. This
is the default if count is not specified.
count requests that weighted cell counts be displayed.
se requests that the standard errors of cell proportions (the default) or
weighted counts be displayed. When se (or ci, deff, or deft) is
specified, only one of cell or count can be selected. The standard
error computed is the standard error of the one selected.
ci requests confidence intervals for cell proportions or weighted counts.
deff and deft request that the design-effect measure DEFF and DEFT be
displayed for each cell proportion or weighted count. See [SVY]
estat for details.
Options deff and deft are not allowed with estimation results that
used direct standardization of poststratification.
srssubpop requests that DEFF and DEFT be computed using an estimate of
SRS (simple random sampling) variance for sampling within a
subpopulation. By default, DEFF and DEFT are computed using an
estimate of the SRS variance for sampling from the entire population.
Typically, srssubpop would be given when computing subpopulation
estimates by strata or by groups of strata.
obs requests that the number of observations for each cell be displayed.
+-----------+
----+ Reporting +--------------------------------------------------------
level(#) specifies the confidence level, as a percentage, for confidence
intervals. The default is level(95) or as set by set level.
proportion, the default, requests that proportions be displayed.
percent requests that percentages be displayed instead of proportions.
nomarginal requests that column marginal not be displayed.
nolabel requests that variable labels and value labels be ignored.
cellwidth(#), csepwidth(#), and stubwidth(#) specify widths of table
elements in the output; see [P] tabdisp. Acceptable values for the
stubwidth() option range from 4 to 32.
format(%fmt) specifies a format for the items in the table. The default
is format(%6.0g). See [U] 12.5 Formats: Controlling how data are
displayed.
svy: tabulate uses the tabdisp command (see [P] tabdisp) to produce the
table. Only five items can be displayed in the table at one time. The ci
option implies two items. If too many items are selected, a warning will
appear immediately. To view more items, redisplay the table while
specifying different options.
Examples
. webuse nhanes2b
. svyset psuid [pweight=finalwgt], strata(stratid)
. svy: tabulate race
. svy: tabulate race, format(%11.3g) count ci deff deft
Saved results
In addition to the results documented in [SVY] svy, svy: tabulate also
saves the following in e():
Scalars
e(r) number of rows
e(total) weighted sum of tab() variable
Macros
e(cmd) tabulate
e(tab) tab() variable
e(rowlab) label or empty
e(rowvlab) row variable label
e(rowvar) varname, the row variable
e(setype) cell or count
Matrices
e(Prop) matrix of cell proportions
e(Obs) matrix of observation counts
e(Deff) DEFF vector for e(setype) items
e(Deft) DEFT vector for e(setype) items
e(Row) values for row variable
e(V_row) variance for row totals
e(V_srs_row) V_srs for row totals
e(Deff_row) DEFF for row totals
e(Deft_row) DEFT for row totals
Also see
Manual: [SVY] svy: tabulate oneway
Help: [SVY] svy postestimation;
[SVY] svy: tabulate twoway, [SVY] svydescribe, [R] tabulate
oneway
