update_recessions: Update recessions table

In CMAP-REPOS/cmapplot: CMAP Themes and Color Palettes

Update recessions table

Description

The cmapplot package contains an internal dataset recessions of all recessions in American history as recorded by the National Bureau of Economic Research (NBER). However, users may need to replace the built-in data, such as in the event of new recessions and/or changes to the NBER consensus on recession dates. This function fetches and interprets this data from the NBER website.

Usage

update_recessions(url = NULL, quietly = FALSE)

Arguments

url	Char, the web location of the NBER machine-readable CSV file. The default, NULL, uses the most recently identified URL known to the package development team, which appears to be the most stable location for updates over time.
quietly	Logical, suppresses messages produced by utils::download.file.

Value

A data frame with the following variables:

• start_char, end_char: Chr. Easily readable labels for the beginning and end of the recession.

• start_date, end_date: Date. Dates expressed in R datetime format, using the first day of the specified month.

• ongoing: Logical. Whether or not the recession is ongoing as of the latest available NBER data.

Source

https://www.nber.org/data/cycles/cycle dates pasted.csv

Examples

recessions <- update_recessions()

# package maintainers can update the internal dataset from within
# package by running the following code:
## Not run: 
  recessions <- update_recessions()
  usethis::use_data(recessions, internal = TRUE, overwrite = TRUE)

## End(Not run)

CMAP-REPOS/cmapplot documentation built on March 29, 2025, 11:55 a.m.