The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.
Provides a daily summary of COVID-19 cases, deaths, recovered, tests, vaccinations, and hospitalizations for 230+ countries, 760+ regions, and 12000+ administrative divisions of lower level. Includes policy measures, mobility data, and geospatial identifiers. Data source: COVID-19 Data Hub https://covid19datahub.io
# install the package
install.packages("COVID19")
# load the package
library("COVID19")
The only function in the package is covid19()
.
By default, the function downloads worldwide data by country:
<- covid19() x
The argument level
specifies the granularity of the
data:
Download worldwide data by state:
<- covid19(level = 2) x
The argument country
filters the data by country. This
is a vector of country names or ISO
codes (ISO 3166-1 Alpha-2 code, Alpha-3 code, or numeric code).
Download data for Italy and Unites States at county/province level:
<- covid19(country = c("Italy", "US"), level = 3) x
The arguments start
and end
specify the
period of interest. The data are subsetted to match this time range.
Download national-level data for United States from 01 October 2021 to 01 November 2021:
<- covid19("US", start = "2021-10-01", end = "2021-11-01") x
The parameter vintage
allows to retrieve the snapshot of
the dataset that was available on the given date. This typically differs
from subsetting the latest data, as most governments are updating the
data retroactively. Available since 14 April, 2020.
Retrieve the data that were available on 15 May, 2020:
<- covid19(vintage = "2020-05-15") x
The argument dir
specifies the folder where the data
files are to be downloaded. By default this is a temporary folder.
Download the files in the folder data
:
dir.create("data")
<- covid19(dir = "data") x
Country-level covariates by World Bank Open Data can be added
via the argument wb
. This is a character vector of
indicator codes to download. The codes can be found by inspecting the
corresponding URL. For example, the code of the indicator “Hospital beds
(per 1,000 people)” available at
https://data.worldbank.org/indicator/SH.MED.BEDS.ZS is
SH.MED.BEDS.ZS
. The indicators are typically available at a
yearly frequency. This function returns the latest data available
between the start
and the end
date. Example
using GDP and number of hospital beds:
<- covid19(wb = c("gdp" = "NY.GDP.MKTP.CD", "hosp_beds" = "SH.MED.BEDS.ZS")) x
Mobility data by Google Mobility
Reports can be added via the argument gmr
. This is the
link to the Google “CSV by geographic area” ZIP folder. At the time of
writing, the link is
https://www.gstatic.com/covid19/mobility/Region_Mobility_Report_CSVs.zip.
As the link has been stable since the beginning of the pandemic, the
function accepts gmr=TRUE
to automatically use this
link.
<- covid19(gmr = TRUE) x
As of April 14, 2022, Apple is no longer providing COVID-19 mobility trends reports.
If you have downloaded the data file previously, you can still use it by
setting amr="path/to/file.csv"
.
<- covid19(amr = "path/to/file.csv") x
See the full documentation online,
or in R by typing ?covid19
Guidotti, E., Ardia, D., (2020), “COVID-19 Data Hub”, Journal of Open Source Software 5(51):2376, doi: 10.21105/joss.02376.
A BibTeX entry for LaTeX users is
@Article{,
title = {COVID-19 Data Hub},
year = {2020},
doi = {10.21105/joss.02376},
author = {Emanuele Guidotti and David Ardia},
journal = {Journal of Open Source Software},
volume = {5},
number = {51},
pages = {2376} }
These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.