EdSurvey (version 2.2.3)

summary2: Summarize edsurvey.data.frame Variables

Description

Summarizes edsurvey.data.frame variables.

Usage

summary2(data, variable, weightVar = attr(getAttributes(data, "weights"),
  "default"), omittedLevels = FALSE)

Arguments

data

an edsurvey.data.frame or light.edsurvey.data.frame

variable

character variable name

weightVar

character weight variable name. Default to be the default weight of data if exists. If the given survey data does not have a default weight, the function will produce unweighted statistics instead. Can be set to NULL to return unweighted statistics.

omittedLevels

a logical value. When set to TRUE, drops those levels of the specified variable. Use print on an edsurvey.data.frame to see the omitted levels. Defaults to FALSE.

Value

summary of weighted or unweighted statistics of a given variable in an edsurvey.data.frame

For categorical variables, summary results include:

N

number of cases for each category. Weighted N is also produced if users choose to produce weighted statistics.

Percent

percentage of each category. Weighted Percent is also produced if users choose to produce weighted statistics.

SE

standard error of the percentage statistics

For continuous variables, summary results include:

N

total number of cases (both valid and invalid cases)

Min.

smallest value of the variable

1st Qu.

first quantile of the variable

Median

median value of the variable

Mean

mean of the variable

3rd Qu.

third quantile of the variable

Max.

largest value of the variable

SD

standard deviation or weighted standard deviation

NA's

number of NA's in variable and in weight variables

Zero-weight's

number of zero-weight cases if users choose to produce weighted statistics

If the weight option is chosen, the function produces weighted percentile and standard deviation. Refer to the vignette titled Statistics and the vignette titled Percentile for how the function calculates these statistics (with and without plausible values).

See Also

percentile

Examples

# NOT RUN {
# read in the example data (generated, not real student data)
sdf <- readNAEP(system.file("extdata/data", "M36NT2PM.dat", package = "NAEPprimer"))

# print out summary of weighted statistics of a continuous variable
summary2(sdf, "composite")

# }
# NOT RUN {
# print out summary of weighted statistics of a variable including omitted levels
summary2(sdf, "b017451", omittedLevels = FALSE)

# print out summary of unweighted statistics of a variable
summary2(sdf, "composite", weightVar = NULL)
# }