Learn R Programming

Economic Data Processing R Library

Utilities to retrieve and tidy U.S. macroeconomic data series from public government data providers. Functions streamline access to series from the Federal Reserve Bank of St. Louis Federal Reserve Economic Data (FRED), the Bureau of Labor Statistics (BLS) flat files, and the Bureau of Economic Analysis (BEA) National Income and Product Accounts (NIPA) tables, then return consistent, tidy data frames ready for modeling and graphics. The package includes helpers for date alignment, log-linear projections, and common macro diagnostics, along with convenience plot builders for quick publication-quality charts.

Functions and Examples

1. getBLSFiles

  • Purpose: Downloads and processes data from the Bureau of Labor Statistics (BLS).
  • Example:
bls_data <- getBLSFiles(data_source = "cpi", email = "user@example.com")

2. getFRED

  • Purpose: Downloads and merges economic data series from the Federal Reserve Economic Data (FRED).
  • Example:
fred_data <- getFRED(variables = prime_epop = "LNS12300060", cpi = "CPIAUCSL"))

3. getPCEInflation

  • Purpose: Loads and processes Personal Consumption Expenditures (PCE) data.
  • Example:
pce_data <- getPCEInflation("M")
  • The parameter "M" specifies monthly data frequency. Use "Q" for quarterly data.

4. getNIPAFiles

  • Purpose: Downloads and formats BEA NIPA data flate files, either monthly or quarterly values.
  • Example:
nipa_data <- getNIPAFiles(type = "Q")

4. logLinearProjection

  • Purpose: Performs log-linear projections on historical data. Must be called within dplyr verbs.
  • Example:
projected_values <- logLinearProjection(date_col = date, value_col = gdp, start_date = "2020-01-01", end_date = "2021-01-01")

Dependencies

  • dplyr
  • tidyr
  • readr
  • purrr
  • rlang
  • stringi

License

This library is distributed under the MIT License. The MIT license permits reuse of software under permissive conditions, provided that all copies include the license terms and the copyright notice.

Copy Link

Version

Install

install.packages('tidyusmacro')

Monthly Downloads

136

Version

0.1.0

License

MIT + file LICENSE

Maintainer

Mike Konczal

Last Published

September 30th, 2025

Functions in tidyusmacro (0.1.0)

date_breaks_n

Create evenly spaced breaks
esp_pal

ESP Color Palette
date_breaks_gg

Date breaks anchored to last data month (for ggplot)
esp_theme

ESP Theme and Color Scales
getPCEInflation

Load and Process Personal Consumption Expenditures (PCE) Data
getFRED

Download and Merge FRED Series
logLinearProjection

Log-Linear Projection (data-masked, dplyr-native)
getUnrateFRED

Get Full Unemployment Rate from FRED
getNIPAFiles

Download and Process BEA NIPA Files with Fast Row Expansion
getBLSFiles

Download and Process BLS Time Series Files with Vectorized Date Assignment
cesDiffusionIndex

cesDiffusionIndex Dataset
esp_navy

ESP Primary Color (Navy)