Estimating the proportion of cases that are ascertained during an outbreak
Source:vignettes/estimate_ascertainment.Rmd
estimate_ascertainment.Rmd
The ascertainment of cases during an outbreak is influenced by a
multiple factor including testing capacity, the case definition, and
sampling regime (e.g. symptom-based testing rather than random
sampling). estimate_ascertainment()
offers a convenient way
to calculate the proportion of cases that is ascertained using a cases
and deaths time-series, a baseline “known” severity, and optionally a
distribution of delays between case reporting and death.
The ascertainment ratio is calculated as the disease severity calculated from the data, divided by the “known” disease severity known or assumed from our best knowledge of the pathology of the disease.
estimate_ascertainment()
uses cfr_static()
internally to estimate the delay-adjusted severity of the disease.
New to calculating disease severity using cfr? You might want to see the “Get started” vignette first.
Use case
The ascertainment of cases in an outbreak is not perfect. We want to estimate the proportion of cases being ascertained given case and death data.
What we have
- A time-series of cases and deaths, (cases may be substituted by another indicator of infections over time);
- Data on the distribution of delays, describing the probability an individual will die days after they were initially infected.
# load {cfr} and data packages
library(cfr)
# packages to wrangle and plot data
library(dplyr)
#> Error in get(paste0(generic, ".", class), envir = get_method_env()) :
#> object 'type_sum.accel' not found
library(tidyr)
library(purrr)
library(scales)
library(forcats)
library(ggplot2)
Note that estimate_static()
is used to
generate a severity estimate which is compared against a ‘known’
severity estimate to calculate the ascertainment ratio. See the vignette on static severity
estimation to learn more about how estimate_static()
chooses a method for profile likelihood generation and hence CFR
estimation.
Ascertainment for the Covid-19 pandemic in the U.K.
This example shows ascertainment ratio estimation using cfr and data from the Covid-19 pandemic in the United Kingdom.
We load example Covid-19 daily case and death data provided with the
cfr package as covid_data
, and subset for the
first six months of U.K. data.
# get Covid data provided with the package
data("covid_data")
# filter for the U.K
df_covid_uk <- filter(
covid_data,
country == "United Kingdom", date <= "2020-06-30"
)
# view the data format
tail(df_covid_uk)
#> date country cases deaths
#> 175 2020-06-25 United Kingdom 883 97
#> 176 2020-06-26 United Kingdom 777 101
#> 177 2020-06-27 United Kingdom 726 108
#> 178 2020-06-28 United Kingdom 666 79
#> 179 2020-06-29 United Kingdom 653 73
#> 180 2020-06-30 United Kingdom 449 70
We obtain the appropriate distribution reported in Linton et al. (2020); this is a log-normal distribution with = 2.577 and = 0.440.
Note that Linton et al. (2020) fitted a discrete lognormal distribution — but we use a continuous distribution here. See the vignette on delay distributions for more on when using a continuous instead of discrete distribution is acceptable, and on using discrete distributions with cfr.
Note that we use the central estimates for each distribution parameter, and by ignoring uncertainty in these parameters the uncertainty in the resulting CFR is likely to be underestimated.
Estimating the proportion of cases that have been ascertained
We use the estimate_ascertainment()
function to
calculate the static CFR (internally), and the overall ascertainment for
the Covid-19 pandemic in the U.K.
We assume that the “true” CFR of Covid-19 is 0.014 (i.e. 1.4%) (Verity et al. 2020). Future plans for this package include ability to incorporate uncertainty in CFR estimates when calculating under-ascertainment.
Note that the CFR from Verity et al. (2020) is based on lab-confirmed and clinically diagnosed cases from Wuhan, China. Since the case definition for the U.K. is different from that used here, the ascertainment ratio estimated is likely to be biased.
Furthermore, by ignoring uncertainty in this estimate, the ascertainment ratio is likely to be over-precise as well.
# static ascertainment on data
estimate_ascertainment(
data = df_covid_uk,
delay_density = function(x) dlnorm(x, meanlog = 2.577, sdlog = 0.440),
severity_baseline = 0.014
)
#> ascertainment_estimate ascertainment_low ascertainment_high
#> 1 0.06779661 0.06734007 0.06829268
Ascertainment in countries with large early Covid-19 pandemics
Finally, we estimate ascertainment for all countries with at least 100,000 reported Covid-19 deaths between 2020 and 2023, and focus on the period between the start of each outbreak to the 1st of June 2020.
We now use the larger dataset covid_data
made available
with the cfr package. We exclude four countries which only
provide weekly data (with zeros for dates in between), and plot the
ascertainment for each country remaining.
# countries with weekly reporting
weekly_reporting <- c("France", "Germany", "Spain", "Ukraine")
# subset for early covid outbreaks
covid_data_early <- filter(
covid_data, date < "2020-06-01",
!country %in% weekly_reporting
)
# nest the data
df_reporting <- nest(covid_data_early, .by = country)
# define density function
delay_density <- function(x) dlnorm(x, meanlog = 2.577, sdlog = 0.440)
# calculate the reporting rate in each country using
# map on nested dataframes
df_reporting <- mutate(
df_reporting,
reporting = map(
.x = data, .f = estimate_ascertainment,
# arguments to function
severity_baseline = 0.014,
delay_density = delay_density
)
)
#> Total cases = 405843 and p = 0.0171: using Poisson approximation to binomial likelihood.
#> Total cases = 30967 and p = 0.0433: using Poisson approximation to binomial likelihood.
#> Total cases = 163103 and p = 0.031: using Poisson approximation to binomial likelihood.
# unnest the data
df_reporting <- unnest(df_reporting, cols = "reporting")
# visualise the data
head(df_reporting)
#> # A tibble: 6 × 5
#> country data ascertainment_estimate ascertainment_low ascertainment_high
#> <chr> <list> <dbl> <dbl> <dbl>
#> 1 Argentina <tibble> 0.130 0.124 0.137
#> 2 Brazil <tibble> 0.112 0.111 0.113
#> 3 Colombia <tibble> 0.236 0.222 0.252
#> 4 India <tibble> 0.253 0.247 0.260
#> 5 Indonesia <tibble> 0.153 0.146 0.161
#> 6 Iran <tibble> 0.215 0.211 0.219
df_reporting %>%
ggplot() +
geom_pointrange(
aes(
x = fct_reorder(country, ascertainment_estimate),
y = ascertainment_estimate,
ymin = ascertainment_low,
ymax = ascertainment_high
)
) +
coord_flip() +
labs(x = NULL, y = "Ascertainment ratio") +
theme(legend.position = "none") +
scale_y_continuous(
labels = percent, limits = c(0, 1)
) +
theme_classic() +
theme(legend.position = "top")