R • COVID-19 Data Hub

GitHub: https://github.com/covid19datahub/R

CRAN: https://cloud.r-project.org/package=COVID19

Quickstart

# install the package
install.packages("COVID19")

# load the package
library("COVID19")

Download the data

See the full documentation by typing ?covid19

# Worldwide data by country
x <- covid19()

# Worldwide data by state
x <- covid19(level = 2)

# Specific country data by city
x <- covid19(c("Italy","US"), level = 3)

Raw data

Logical. Skip data cleaning? Default True. If raw=False, the raw data are cleaned by filling missing dates with NA values. This ensures that all locations share the same grid of dates and no single day is skipped. Then, NA values are replaced with the previous non-NA value or 0.

x <- covid19(raw = FALSE)

Vintage

Logical. Retrieve the snapshot of the dataset that was generated at the end date instead of using the latest version. Default FALSE.

To fetch e.g. US data that were accessible on 22th April 2020 type

x <- covid19("USA", end = "2020-04-22", vintage = TRUE)

The vintage data are collected at the end of the day, but published with approximately 48 hour delay, once the day is completed in all the timezones.

Merge with World Bank Open Data

The dataset can be extended with World Bank Open Data via the argument wb, a character vector of indicator codes. The codes can be found by inspecting the corresponding URL. For example, the code of the GDP indicator available at https://data.worldbank.org/indicator/NY.GDP.MKTP.CD is NY.GDP.MKTP.CD.

wb <- c("gdp" = "NY.GDP.MKTP.CD", "hosp_beds" = "SH.MED.BEDS.ZS")
x  <- covid19(wb = wb)

Merge with Google Mobility Reports

The dataset can be extended with Google Mobility Reports via the argument gmr, the url to the Google CSV file. At the time of writing, the CSV is available at:

gmr <- "https://www.gstatic.com/covid19/mobility/Global_Mobility_Report.csv"
x   <- covid19(gmr = gmr)

Merge with Apple Mobility Reports

The dataset can be extended with Apple Mobility Reports via the argument amr, the url to the Apple CSV file. At the time of writing, the CSV is available at:

amr <- "https://covid19-static.cdn-apple.com/covid19-mobility-data/"
amr <- paste0(amr, "2015HotfixDev10/v3/en-us/applemobilitytrends-2020-08-24.csv")
x   <- covid19(amr = amr)

Data sources

Data sources are stored in the src attribute.

s <- covid19cite(x)
View(s)

Terms of Use

We have invested a lot of time and effort in creating COVID-19 Data Hub, please:

cite Guidotti and Ardia (2020) when using COVID-19 Data Hub.
place the URL https://covid19datahub.io in a footnote to help others find COVID-19 Data Hub.
you assume full risk for the use of COVID-19 Data Hub. We try our best to guarantee the data quality and consistency and the continuous filling of the Data Hub. However, it is free software and comes with ABSOLUTELY NO WARRANTY. Reliance on COVID-19 Data Hub for medical guidance or use of COVID-19 Data Hub in commerce is strictly prohibited.

License: GPL-3.

R