wru (version 0.1-1)

census.helper.api.local: Census helper function.

Description

census.helper.api.local links user-input dataset with Census data.

Usage

census.helper.api.local(voters, states = "all", geo = "tract", demo = FALSE, census.data = NA)

Arguments

voters

An object of class data.frame. Must contain field(s) named county, tract, and/or block specifying geolocation. These should be character variables that match up with U.S. Census categories. County should be three characters (e.g., "031" not "31"), tract should be six characters, and block should be four characters.

states

A state to use Census data for, e.g. c("NJ", "NY"). Default is "NA".

geo

A character object specifying what aggregation level to use. Use "county", "tract", or "block". Default is "tract". Warning: extracting block-level data takes very long.

demo

A TRUE/FALSE object indicating whether to condition on demographics (i.e., age and sex) or not. If TRUE, function will return Pr(Geolocation, Age, Sex | Race). If FALSE, function wil return Pr(Geolocation | Race). Default is FALSE.

census.data

A optional census object holding census data that is already provided. If missing, function will retrive the census data online.

Value

Output will be an object of class data.frame. It will consist of the original user-input data with additional columns of Census data.

Details

This function allows users to link their geocoded dataset (e.g., voter file) with U.S. Census 2010 data. The function extracts Census Summary File data at the tract or block level using the 'UScensus2010' package. Census data calculated are Pr(Geolocation | Race) where geolocation is tract or block.

References

Relies on getCensusApi, getCensusApi2, and vecToChunk functions authored by Nicholas Nagle, available here.

Examples

## Not run: census.helper.api.local(voters = voters, states = "nj", geo = "block", census.data = x)
## Not run: census.helper.api.local(voters = voters, states = "all", geo = "tract", demo = TRUE, 
# census.data = x)## End(Not run)