openintrostat / usdata

📦 Data on the states and counties of the United States 🇺🇸

usdata

This package contains demographic data on the United States at the county and state levels. The data span multiple years. Sources include the US Census, the American Community Survey, data distributed by the Bureau of Labor Statistics, etc.

Installation

You can install the package from CRAN with:

install.packages("usdata")

Additionally, you can install the development version of usdata from GitHub with:

#install.packages("devtools")
library(devtools)
install_github("OpenIntroStat/usdata")

Usage

The datasets from this package can be used in a teaching context for data visualization and data manipulation exercises as well as for modeling. Since data spans multiple years it’s also possible to use these data to explore trends in the US over time.

usdata and openintro

The datasets from this package are used in OpenIntro textbooks and other resources. These datasets originally lived in the openintro package, up until openintro 2.0.0. The motivation for extracting these datasets out of the openintro package was to create a new package where we can continue to add more data on the US at the state and county levels. For those looking for a seamless experience with OpenIntro resources, note that the contents of this package will be loaded along with the openintro package as well, so that you can run library(openintro) and use the datasets from usdata.

Questions, bugs, feature requests

You can file an issue to get help, report a bug, or make a feature request.

When filing an issue to get help or report a bug, please make a minimal reproducible example using the reprex package. If you haven’t heard of or used reprex before, you’re in for a treat! See here for additional reprex pointers.

Before opening a new issue, be sure to search issues and pull requests to make sure the bug hasn’t been reported and/or already fixed in the development version. By default, the search will be pre-populated with is:issue is:open. You can edit the qualifiers (e.g. is:pr, is:closed) as needed. For example, you’d simply remove is:open to search all issues in the repository, open or closed.

Code of Conduct

Please note that the usdata project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

usdata's Issues

update county_complete

It would be fantastic for someone to update the county_complete OpenIntro dataset. See "Source" here: https://openintrostat.github.io/usdata/reference/county_complete.html

washington DC state2abbrev wrong

state2abbr("washington dc") gives "WA" rather than "dc"

Add U.S. territories to state2abbr() and abbr2state()

If possible, it would be great if state2abbr() and abbr2state() included U.S. territories, i.e. those listed on this page (https://www.census.gov/library/reference/code-lists/ansi/ansi-codes-for-states.html) under "FIPS Codes for Outlying Areas of the United States and the Freely Associated States"

veterans_2010 seems like a count of veterans, not a percent

This is an awesome resource! Just noting that the variable veterans_2010 in county_complete seems like a count, while the documentation indicates it is "Percent of population that are veterans (2006-2010)."

Update authors

Add @ldorazio to authors in next release for her contributions for gathering the county data