Convert a data frame returned by get_pums() to a survey object

This helper function takes a data frame returned by get_pums and converts it to a tbl_svy from the srvyr as_survey package or a svyrep.design object from the svrepdesign package. You can then use functions from the srvyr or survey to calculate weighted estimates with replicate weights included to provide accurate standard errors.

to_survey(
  df,
  type = c("person", "housing"),
  class = c("srvyr", "survey"),
  design = "rep_weights"
)

Arguments

df: A data frame with PUMS person or housing weight variables, most likely returned by get_pums.
type: Whether to use person or housing-level weights; either "housing" or "person" (the default).
class: Whether to convert to a srvyr or survey object; either "survey" or "srvyr" (the default).
design: The survey design to use when creating a survey object. Currently the only option is "rep_weights".

Value

A tbl_svy or svyrep.design object.

Examples

if (FALSE) { # \dontrun{
pums <- get_pums(variables = "AGEP", state = "VT", rep_weights = "person")
pums_design <- to_survey(pums, type = "person", class = "srvyr")
survey::svymean(~AGEP, pums_design)
} # }