srvyr (version 0.3.1)

as_survey_rep: Create a tbl_svy survey object using replicate weights

Description

Create a survey object with replicate weights.

Usage

as_survey_rep(.data, ...)
# S3 method for data.frame
as_survey_rep(.data, variables = NULL,
  repweights = NULL, weights = NULL, type = c("BRR", "Fay", "JK1", "JKn",
  "bootstrap", "other"), combined_weights = TRUE, rho = NULL,
  bootstrap_average = NULL, scale = NULL, rscales = NULL, fpc = NULL,
  fpctype = c("fraction", "correction"),
  mse = getOption("survey.replicates.mse"), ...)
# S3 method for tbl_lazy
as_survey_rep(.data, variables = NULL, repweights = NULL,
  weights = NULL, type = c("BRR", "Fay", "JK1", "JKn", "bootstrap",
  "other"), combined_weights = TRUE, rho = NULL, bootstrap_average = NULL,
  scale = NULL, rscales = NULL, fpc = NULL, fpctype = c("fraction",
  "correction"), mse = getOption("survey.replicates.mse"), ...)
# S3 method for svyrep.design
as_survey_rep(.data, ...)
# S3 method for survey.design2
as_survey_rep(.data, type = c("auto", "JK1", "JKn",
  "BRR", "bootstrap", "subbootstrap", "mrbbootstrap", "Fay"), rho = 0,
  fpc = NULL, fpctype = NULL, ..., compress = TRUE,
  mse = getOption("survey.replicates.mse"))
# S3 method for tbl_svy
as_survey_rep(.data, type = c("auto", "JK1", "JKn", "BRR",
  "bootstrap", "subbootstrap", "mrbbootstrap", "Fay"), rho = 0, fpc = NULL,
  fpctype = NULL, ..., compress = TRUE,
  mse = getOption("survey.replicates.mse"))

Arguments

.data

A data frame (which contains the variables specified below)

...

ignored

variables

Variables to include in the design (default is all)

repweights

Variables specifying the replication weight varibles

weights

Variables specifying sampling weights

type

Type of replication weights

combined_weights

TRUE if the repweights already include the sampling weights. This is usually the case.

rho

Shrinkage factor fo rweights in Fay's method

bootstrap_average

For type = "bootstrap", if the bootstrap weights have been averaged, gives the number of iterations averaged over.

scale, rscales

Scaling constant for variance, see svrepdesign for more information.

fpc, fpctype

Finite population correction information

mse

if TRUE, compute varainces based on sum of squares around the point estimate, rather than the mean of the replicates

compress

if TRUE, store replicate weights in compressed form (if converting from design)

Value

An object of class tbl_svy

Details

If provided a data.frame, it is a wrapper around svrepdesign. All survey variables must be included in the data.frame itself. Variables are selected by using bare column names, or convenience functions described in select.

If provided a svyrep.design object from the survey package, it will turn it into a srvyr object, so that srvyr functions will work with it

If provided a survey design (survey.design2 or tbl_svy), it is a wrapper around as.svrepdesign, and will convert from a survey design to replicate weights.

Examples

# NOT RUN {
# Examples from ?survey::svrepdesign()
library(survey)
library(dplyr)
data(scd)
# use BRR replicate weights from Levy and Lemeshow
scd <- scd %>%
  mutate(rep1 = 2 * c(1, 0, 1, 0, 1, 0),
         rep2 = 2 * c(1, 0, 0, 1, 0, 1),
         rep3 = 2 * c(0, 1, 1, 0, 0, 1),
         rep4 = 2 * c(0, 1, 0, 1, 1, 0))

scdrep <- scd %>%
  as_survey_rep(type = "BRR", repweights = starts_with("rep"),
                combined_weights = FALSE)

# dplyr 0.7 introduced new style of NSE called quosures
# See `vignette("programming", package = "dplyr")` for details
repwts <- quo(starts_with("rep"))
scdrep <- scd %>%
  as_survey_rep(type = "BRR", repweights = !!repwts,
                combined_weights = FALSE)

# }