build_dec {censable}R Documentation

Build Data from the Decennial Census

Description

Creates a dataset, using the decennial census information, with the standard variables used for redistricting. Creates a stable base for getting data from tidycensus for common calls in redistricting.

Usage

build_dec(
  geography,
  state,
  county = NULL,
  geometry = TRUE,
  year = 2020,
  groups = "all"
)

mem_build_dec(
  geography,
  state,
  county = NULL,
  geometry = TRUE,
  year = 2020,
  groups = "all"
)

Arguments

geography

Required. The geography level to use.

state

Required. Two letter state postal code.

county

Optional. Name of county. If not provided, returns blocks for the entire state.

geometry

Defaults to TRUE. Whether to return the geometry or not.

year

year, must be 2000, 2010, or 2020 (after August 2021)

groups

defaults to 'all', which gets pop and vap. If 'pop', only gets pop. If 'vap', only gets vap. Any other strings default to 'all'.

Value

tibble with observations for each observation of the geography in the state or county. Data includes 2 sets of columns for each race or ethnicity category: population (pop) and voting age population (vap)

Output columns are:

Arguments for geography are not checked, so will fail with tidycensus errors if invalid. This is by design to avoid blocking usage that could become valid, especially following the 2020 Census data release.

Currently valid options for geography:

Full options for geography that may or may not be valid depending on year and geometry are listed at: Kyle Walker's tidycensus site.

Examples

## Not run: 
# uses the Census API
tb <- build_dec(geography = 'block', state = 'NY', county = 'Rockland', geometry = TRUE)

## End(Not run)

[Package censable version 0.0.3 Index]