state_choropleth_acs: Create a US State choropleth from ACS data

Description

Creates a choropleth of US States using the US Census' American Community Survey (ACS) data. Requires the acs package to be installed, and a Census API Key to be set with the acs's api.key.install function. Census API keys can be obtained at http://www.census.gov/developers/tos/key_request.html.

Usage

state_choropleth_acs(
  tableId,
  endyear = 2011,
  span = 5,
  num_colors = 7,
  zoom = NULL
)

Value

A choropleth.

Arguments

tableId: The id of an ACS table
endyear: The end year of the survey to use. See acs.fetch (?acs.fetch) and http://1.usa.gov/1geFSSj for details.
span: The span of time to use. See acs.fetch and http://1.usa.gov/1geFSSj for details.
num_colors: The number of colors on the map. A value of 1 will use a continuous scale. A value in [2, 9] will use that many colors.
zoom: An optional list of states to zoom in on. Must come from the "name" column in ?state.regions.

References

Uses the acs package created by Ezra Haber Glenn.

Examples

Run this code

if (FALSE) {
# median income, default parameters
state_choropleth_acs("B19301")

# continuous scale, zooming in on New York, New Jersey and Connecticut
state_choropleth_acs("B19301", num_colors=1, zoom=c("new york", "new jersey", "connecticut"))
}