censusapi (version 0.3.0)

makeVarlist: Use variable metadata to find variables containing a given string.

Description

Return a list of variable names or data frame of variable metadata containing a given string. This can be used create a list of variables to later pass to getCensus, or a data frame documenting variables used in a given project.

Usage

makeVarlist(name, vintage = NULL, find, varsearch = "all",
  output = "list")

Arguments

name

API name - e.g. acs5. See list at https://api.census.gov/data.html

vintage

Year of dataset, e.g. 2014 - not required for timeseries APIs

find

A string to find in the variable metadata

varsearch

Optional argument specifying which fields to search. Default is "all". Options are "all", "name", "label", or "concept".

output

Optional argument, specifying output to "list" or "dataframe". Default is "list".

Examples

# NOT RUN {
# Return a list, and then use getCensus function to retrieve those variables
# }
# NOT RUN {
myvars <- makeVarlist(name = "sf1", vintage = 2000,
	find = "military", varsearch = "label")
militarydt <- getCensus(name = "sf1", vintage = 2000,
	vars = myvars, region = "state:*")

# Return a data frame of all "h16" variables
vartable <- makeVarlist(name = "sf1", vintage = 2000,
	find = "h16", varsearch = "concept",
	output = "dataframe")
# }