census

To call the script,

source("https://raw.githubusercontent.com/hungkitwchiu/census/main/census.R")

To use the census related functions, make sure you load tidycensus, tidyverse or other necessary packages, and make sure that you have your census API key stored the environment otherwise you will be limited to 500 calls per day. API key can be obtained from Census.

Functions

get.census() wrapper for get_acs() or get_decennial() to get multiple years at once

• state : chr such as "CA" or "06" (NOTE: a numeric 6 will not work)

• county : chr such as "San Francisco" or "075"

• geography : chr such as "tract", "block group" or "county subdivision"

• years : numeric or vector of integers

• variables : chr variables as in load_variables(year, survey)

• geometry = FALSE : get shape data if TRUE

• survey = "acs5" : default survey variance set to "acs5"

• acs = TRUE : default call get_acs, if FALSE, call get_decennial

• years.id = "year" : chr column name assigned to year column

function get.census.list() wrapper for get.census() get multiple state-county at once

• state.county.list: nested list of states and counties in the form of list(list(state1, list(county1, county2)), list(state2, list(county1))) and so on

function census.crosswalk() crosswalk data using weights from NHGIS

• crosswalk.file : data.frame or data.table of the correct crosswalk file from NHGIS

• col.start : chr column name of the originating GEOID

• col.end : chr column name of the target GEOID

• col.weight : chr column name of the interpolation weight

• data.walk : data.frame or data.table of the census data that needs to be crosswalked

• cols.walk : chr column name of the variable to be crosswalked; can be a vector

• col.year = NULL : chr column name of the year column, if any; note that only data from the same decade can be fed into the function

function get.geometry() function for getting Census geographies for a given data set

NOTE: This function treats (0,0) coordinates (including floating point zeros) as NA

• data.interest : data with rows of GPS location that requires mapping to Census geographies, assumed to be ESPG:4326 (the standard GPS longitude and latitude)

• coords.name : character vector of 2 elements, with first one being column name of longitude (X), and second one being column name of latitude (Y)

• data.shape : relevant spatial data with geography information (e.g., TIGER/Line Shapefiles)

• parallel : if TRUE, run code in parallel using multiple cores

• crs : Corodinate reference system of the coordinates in data.interest if it is not WGS84 or EPSG:4326