https://github.com/christopherkenny/censable

Making Census Data More Usable
https://github.com/christopherkenny/censable

Last synced: about 2 months ago
JSON representation

Making Census Data More Usable

• Host: GitHub
• URL: https://github.com/christopherkenny/censable
• Owner: christopherkenny
• License: other
• Created: 2021-06-12T19:17:10.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-03-20T19:39:26.000Z (6 months ago)
• Last Synced: 2024-05-19T23:37:24.127Z (4 months ago)
• Language: R
• Homepage: https://www.christophertkenny.com/censable/
• Size: 1.9 MB
• Stars: 7
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.Rmd
  • License: LICENSE

Awesome Lists containing this project

README

        
---

output: github_document

---

```{r, include = FALSE}

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

  fig.path = "man/figures/README-",

  out.width = "100%"

)

```

# censable 

[![R-CMD-check](https://github.com/christopherkenny/censable/workflows/R-CMD-check/badge.svg)](https://github.com/christopherkenny/censable/actions)

[![censable status badge](https://christopherkenny.r-universe.dev/badges/censable)](https://christopherkenny.r-universe.dev/censable)

[![Lifecycle: stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable)

[![CRAN status](https://www.r-pkg.org/badges/version/censable)](https://CRAN.R-project.org/package=censable)

![CRAN downloads](http://cranlogs.r-pkg.org/badges/grand-total/censable)

`censable` wraps `censusapi` for common requests, with [memoized](https://github.com/r-lib/memoise) data functions. With a growing redistricting universe in R, it seems right to partition out some use cases, to allow imports to be more targeted and to stop packages from repeating each other.

## Installation

You can install the released version of censable from [CRAN](https://CRAN.R-project.org) with:

``` r

install.packages("censable")

```

You can download the development version from [GitHub](https://github.com/) with:

``` r

# install.packages("devtools")

devtools::install_github("christopherkenny/censable")

```

## Example

```{r}

library(censable)

```

The primary data functions are `build_dec` and `build_acs`

```{r, results='hide'}

de <- build_dec(geography = 'county', state = 'DE')

```

The `build_*` functions take arguments on geography and state, at a minimum. If you're looking at a smaller piece of a state, you can use `county` to subset it. Year defaults to 2010, but will be updated to 2020 around October 2021, following the API release of the 2020 Census data.

The `build_*` functions are a convenient wrapper around `censusapi`, with an eye towards collecting data on total population and voting age population by race. Total population variables begin with the prefix `pop`, while voting age population variables begin with the prefix `vap`. 

Additionally, there are memoised versions of the `build_*` functions:

```{r, results='hide'}

de <- mem_build_dec(geography = 'county', state = 'DE')

```

These speed up repeated calls, allowing you to have code that is self contained and reproducible, without taking the time hit of having to re-download the data each time.