Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Zika example to vignette #8

Merged
merged 7 commits into from
Sep 16, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added data/tahiti_2013.rda
Binary file not shown.
57 changes: 50 additions & 7 deletions vignettes/climateR0.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -20,40 +20,40 @@

Temperature is an important driver of vector-borne disease transmission, affecting vector reproduction, development, and survival, as well as the probability of pathogen transmission. Previous work by [Mordecai and colleagues](https://onlinelibrary.wiley.com/doi/10.1111/ele.13335) empirically estimated the effect of temperature on different vector traits, and used these to develop models of temperature dependent R~0~.

The {climateR0} package extracts temperature-dependent R0 for an input time series of mean temperature for 14 vector-pathogen combinations, focusing on mosquito-borne diseases that pose a major public health threat. Temperature dependent R~0~ is a relative measure bounded between 0 and 1, where 1 indicates maximum temperature suitability for transmission. This is a useful indicator for the epidemic potential of a vector-borne disease which can be used for situational awareness or be incorporated into forecasting models to predict future cases. Note that we use a relative measure of R~0~ as other factors affect the absolute magnitude of R~0~ such as immunity, control measures and population behaviour, which are not considered here.
The {climateR0} package extracts temperature-dependent R~0~ for an input time series of mean temperature for 14 vector-pathogen combinations, focusing on mosquito-borne diseases that pose a major public health threat. Temperature dependent R~0~ is a relative measure bounded between 0 and 1, where 1 indicates maximum temperature suitability for transmission. This is a useful indicator for the epidemic potential of a vector-borne disease which can be used for situational awareness or be incorporated into forecasting models to predict future cases. Note that we use a relative measure of R~0~ as other factors affect the absolute magnitude of R~0~ such as immunity, control measures and population behaviour, which are not considered here.

```{r setup, include = FALSE}
library(climateR0)
library(ggplot2)

Check warning on line 27 in vignettes/climateR0.Rmd

View workflow job for this annotation

GitHub Actions / lint-changed-files

file=vignettes/climateR0.Rmd,line=27,col=1,[unused_import_linter] Package 'ggplot2' is only used by namespace. Check that it is installed using loadNamespace() instead.
library(cowplot)

Check warning on line 28 in vignettes/climateR0.Rmd

View workflow job for this annotation

GitHub Actions / lint-changed-files

file=vignettes/climateR0.Rmd,line=28,col=1,[unused_import_linter] Package 'cowplot' is only used by namespace. Check that it is installed using loadNamespace() instead.
```

### Case study - 2013/14 DENV3 outbreak in Fiji

As a case study, we'll use data from a 2013/4 DENV-3 outbreak in Fiji. Here we show laboratory confirmed cases over time in Central Division.
As a first case study, we'll use data from a 2013/4 DENV-3 outbreak in Fiji. Here we show laboratory confirmed cases over time in Central Division.

```{r}
fiji_cases <- fiji_2014 |>

Check warning on line 36 in vignettes/climateR0.Rmd

View workflow job for this annotation

GitHub Actions / lint-changed-files

file=vignettes/climateR0.Rmd,line=36,col=25,[pipe_consistency_linter] Use the %>% pipe operator instead of the |> pipe operator.

Check warning on line 36 in vignettes/climateR0.Rmd

View workflow job for this annotation

GitHub Actions / lint-changed-files

file=vignettes/climateR0.Rmd,line=36,col=27,[trailing_whitespace_linter] Trailing whitespace is superfluous.
ggplot2::ggplot() +
ggplot2::geom_line(ggplot2::aes(x = date, y = cases), col = "#016c59") +
ggplot2::scale_x_date(breaks = "month", date_labels = "%b-%y") +
ggplot2::labs(x = "Date", y = "Cases") +
ggplot2::labs(x = "Date", y = "Reported dengue cases") +
ggplot2::theme_classic()

fiji_cases

```

In the same dataset, we have a time-series of monthly mean temperatures (in °C) for Fiji. To extract corresponding temperature-dependent R~0~ values from the temperature-relative R0 curves estimated by Mordecai et al, we use the `temperature_R0()` function. Within the function call, we specify a vector-pathogen code of `AeaeDENV` for the vector *Aedes aegypti* and pathogen dengue virus.
In the same dataset, we have a time-series of monthly mean temperatures (in °C) for Central Division, Fiji. To extract corresponding temperature-dependent R~0~ values from the temperature-relative R0 curves estimated by Mordecai et al, we use the `temperature_R0()` function. Within the function call, we specify a vector-pathogen code of `AeaeDENV` for the vector *Aedes aegypti* and pathogen dengue virus.

```{r}
fiji_2014$rR0 <- temperature_r0(fiji_2014$av_temp, "AeaeDENV")
```

Now we can plot relative temperature-dependent R0 values alongside case data.
Now we can plot relative temperature-dependent R~0~ values alongside case data.

```{r, include = FALSE}
```{r}
fiji_rR0 <- fiji_2014 |>

Check warning on line 56 in vignettes/climateR0.Rmd

View workflow job for this annotation

GitHub Actions / lint-changed-files

file=vignettes/climateR0.Rmd,line=56,col=23,[pipe_consistency_linter] Use the %>% pipe operator instead of the |> pipe operator.

Check warning on line 56 in vignettes/climateR0.Rmd

View workflow job for this annotation

GitHub Actions / lint-changed-files

file=vignettes/climateR0.Rmd,line=56,col=25,[trailing_whitespace_linter] Trailing whitespace is superfluous.
ggplot2::ggplot() +
ggplot2::geom_line(ggplot2::aes(x = date, y = rR0), col = "#54278f") +
ggplot2::scale_x_date(breaks = "month", date_labels = "%b-%y") +
Expand All @@ -67,4 +67,47 @@
cowplot::plot_grid(fiji_cases, fiji_rR0, nrow = 2)
```

As discussed in [Kucharski et al 2018](https://elifesciences.org/articles/34848#s2), comparing the case time series with temperature-dependent R~0~ indicates that a fall in transmission due to seasonal temperature variation cannot fully explain the fall in cases from March 2014. In this paper, Kucharski and colleagues found that a model including the build-up of herd immunity and a decrease in transmission resulting from a vector control campaign in March 2024 better captured the observed pattern of cases.
As discussed in [Kucharski et al (2018)](https://elifesciences.org/articles/34848#s2), comparing the case time series with temperature-dependent R~0~ indicates that a fall in transmission due to seasonal temperature variation cannot fully explain the fall in cases from March 2014. In this paper, Kucharski and colleagues found that a model including the build-up of herd immunity and a decrease in transmission resulting from a vector control campaign in March 2024 better captured the observed pattern of cases.

### Case study - 2013/14 Zika outbreak in French Polynesia

As a second study, we'll use data from a 2013/4 Zika outbreak in Tahiti, French Polynesia. Here we show laboratory confirmed cases over time from sentinel reporting sites in Tahiti.

```{r}
tahiti_cases <- tahiti_2013 |>

Check warning on line 77 in vignettes/climateR0.Rmd

View workflow job for this annotation

GitHub Actions / lint-changed-files

file=vignettes/climateR0.Rmd,line=77,col=29,[pipe_consistency_linter] Use the %>% pipe operator instead of the |> pipe operator.

Check warning on line 77 in vignettes/climateR0.Rmd

View workflow job for this annotation

GitHub Actions / lint-changed-files

file=vignettes/climateR0.Rmd,line=77,col=31,[trailing_whitespace_linter] Trailing whitespace is superfluous.
ggplot2::ggplot() +
ggplot2::geom_line(ggplot2::aes(x = date, y = cases), col = "#016c59") +
ggplot2::scale_x_date(breaks = "month", date_labels = "%b-%y") +
ggplot2::labs(x = "Date", y = "Reported Zika cases") +
ggplot2::theme_classic()

tahiti_cases

```

In the same dataset, we have a time-series of monthly mean temperatures (in °C) for Tahiti. Again, we use the `temperature_R0()` function. Within the function call, we specify a vector-pathogen code of `AeaeZIKV` for the vector *Aedes aegypti* and pathogen Zika virus. (Note that the main vectors in French Polynesia include both *Ae. aegypti* and *Ae. polynesiensis*.)

```{r}
tahiti_2013$rR0 <- temperature_r0(tahiti_2013$av_temp, "AeaeZIKV")
```

Now we can plot relative temperature-dependent R~0~ values alongside case data.

```{r}
tahiti_rR0 <- tahiti_2013 |>

Check warning on line 97 in vignettes/climateR0.Rmd

View workflow job for this annotation

GitHub Actions / lint-changed-files

file=vignettes/climateR0.Rmd,line=97,col=27,[pipe_consistency_linter] Use the %>% pipe operator instead of the |> pipe operator.

Check warning on line 97 in vignettes/climateR0.Rmd

View workflow job for this annotation

GitHub Actions / lint-changed-files

file=vignettes/climateR0.Rmd,line=97,col=29,[trailing_whitespace_linter] Trailing whitespace is superfluous.
ggplot2::ggplot() +
ggplot2::geom_line(ggplot2::aes(x = date, y = rR0), col = "#54278f") +
ggplot2::scale_x_date(breaks = "month", date_labels = "%b-%y") +
ggplot2::labs(x = "Date", y = "Relative R0") +
ggplot2::theme_classic()

tahiti_rR0
```

```{r}
cowplot::plot_grid(tahiti_cases, tahiti_rR0, nrow = 2)
```

As discussed in [Kucharski et al (201)](https://journals.plos.org/plosntds/article?id=10.1371/journal.pntd.0004726), the outbreak ended before temperature or rainfall levels changed in a way that would imply a transmission reduction, indicating that immunity played a major role in driving the epidemic decline. This is consistent with later antibody data reported by [Aubry et al ( 2017)](https://www.ncbi.nlm.nih.gov/pmc/articles/PMC5367400/)


adamkucharski marked this conversation as resolved.
Show resolved Hide resolved
Loading