A Convenient API for Accessing United States Census Bureau's Quarterly Workforce Indicator

The purpose of this package is to access the United States Census Bureau's Quarterly Workforce Indicator data. Additionally, the data will be retrieved in a tidy format for further manipulation with full variable descriptions added if desired. Information about the United States Census Bureau's Quarterly Workforce Indicator is available at < https://www.census.gov/data/developers/data-sets/qwi.html>.


Travis buildstatus Coveragestatus lifecycle

The goal of tidyqwi is to make accessing the US Census Bureau’s Quarterly Workforce Indicators easier in a tidy format. This package allows a user to specify the years and states of interest as well as some of the additional parameters (desired cross tabs, MSA vs county level data, firm size, etc) and submit them to the US Census API. This package then stays within the US Census guidelines for API submission for this data and returns a combined tidy dataframe for future analysis.

This is a work in progress!

Installation

devtools::install_github("medewitt/tidyqwi")

After installation you can load and retrieve the desired data!

library(tidyqwi)
 
nc_qwi <- get_qwi(years = "2010", 
                  states = "11", 
                  geography = "county", 
                  apikey =  census_key, 
                  quiet = TRUE, endpoint = "rh",
                  variables = c("sEmp", "Emp"), all_groups = FALSE,
                  industry_level = "2", processing = "multiprocess")

And look at your data:

head(nc_qwi)
#> # A tibble: 6 x 12
#>   year  quarter agegrp sex   ownercode seasonadj industry state county
#>   <chr> <chr>   <chr>  <chr> <chr>     <chr>     <chr>    <chr> <chr> 
#> 1 2010  1       A00    0     A00       U         11       37    001   
#> 2 2010  1       A00    0     A00       U         11       37    003   
#> 3 2010  1       A00    0     A00       U         11       37    005   
#> 4 2010  1       A00    0     A00       U         11       37    007   
#> 5 2010  1       A00    0     A00       U         11       37    009   
#> 6 2010  1       A00    0     A00       U         11       37    011   
#> # ... with 3 more variables: Emp <chr>, sEmp <chr>, year_time <date>

And there are labels added if desired

labelled_nc <- add_qwi_labels(nc_qwi)
Hmisc::describe(labelled_nc$Emp)
#> labelled_nc$Emp : Beginning-of-Quarter Employment: Counts 
#>        n  missing distinct     Info     Mean      Gmd      .05      .10 
#>     7345      411     2851        1     2018     3129       24       40 
#>      .25      .50      .75      .90      .95 
#>      132      448     1550     4355     8099 
#> 
#> lowest :     0     1     3     4     5, highest: 65243 81884 82723 84038 84674
library(ggplot2)
library(dplyr)
#> 
#> Attaching package: 'dplyr'
#> The following objects are masked from 'package:stats':
#> 
#>     filter, lag
#> The following objects are masked from 'package:base':
#> 
#>     intersect, setdiff, setequal, union
 
labelled_nc %>%
  filter(county == "067") %>% 
  ggplot(aes(year_time, Emp, color = county))+
  geom_line()+
  scale_y_log10()+
  facet_wrap(~industry)+
  labs(
    title = "Quarterly Workforce Indicators for Forsyth County",
    subtitle = attributes(labelled_nc$Emp)$label,
    caption = "Data: US Census Bureau QWI"
  )+
  theme_minimal()

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

News

tidyqwi 0.1.0

  • Initial release of the tidyqwi package.

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("tidyqwi")

0.1.0 by Michael DeWitt, 21 days ago


Report a bug at https://github.com/medewitt/tidyqwi/issues


Browse source code at https://github.com/cran/tidyqwi


Authors: Michael DeWitt [aut, cre] , Mona Ahmadiani [aut] , Adam Hyde [aut]


Documentation:   PDF Manual  


MIT + file LICENSE license


Imports dplyr, httr, jsonlite, magrittr, xml2, stringr, purrr, stats, tidyr, plyr, labelled, furrr

Depends on future

Suggests testthat, covr, knitr, rmarkdown


See at CRAN