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.
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.
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.
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.
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 \(\mu\) = 2.577 and \(\sigma\) = 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.
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.
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")
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.