Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/adamhsparks/epicrop

Simulation modelling of crop diseases using a Susceptible-Exposed-Infectious-Removed (SEIR) model in R
https://github.com/adamhsparks/epicrop

agricultural-modeling agricultural-modelling agricultural-research botanical-epidemiology crop-protection disease epirice-model model modeling modelling r rice rice-diseases rstats seir seir-model

Last synced: about 1 month ago
JSON representation

Simulation modelling of crop diseases using a Susceptible-Exposed-Infectious-Removed (SEIR) model in R

Awesome Lists containing this project

README

        

---
title: ""
output: github_document
---

# {epicrop} Simulation Modelling of Crop Diseases Using a Susceptible-Exposed-Infectious-Removed (SEIR) Model

```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```

[![tic](https://github.com/adamhsparks/epicrop/workflows/tic/badge.svg?branch=main)](https://github.com/adamhsparks/epicrop/actions)
[![codecov](https://codecov.io/gh/adamhsparks/epicrop/branch/main/graph/badge.svg?token=NWrKsX9MaP)](https://codecov.io/gh/adamhsparks/epicrop)
[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![Lifecycle: stable](https://img.shields.io/badge/lifecycle-stable-green.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable)
[![DOI](https://zenodo.org/badge/58613738.svg)](https://zenodo.org/badge/latestdoi/58613738)

A fork of [{cropsim}](https://r-forge.r-project.org/R/?group_id=335) (Hijmans _et al._ 2009) designed to make using the EPIRICE model (Savary _et al._ 2012) for rice diseases easier to use.
This version provides easy to use functions to fetch weather data from NASA POWER, via the [{nasapower}](https://cran.r-project.org/package=nasapower) package (Sparks 2018, Sparks 2020) and predict disease intensity of five rice diseases using a generic SEIR model (Zadoks 1971) function, `SEIR()`.

The original EPIRICE manuscript, Savary _et al._ (2012), which details the model and results of its use to model global epidemics of rice diseases, was published in _Crop Protection_ detailing global unmanaged disease risk of bacterial blight, brown spot, leaf blast, sheath blight and rice tungro, which are included in this package.

# Quick start

You can easily simulate any of the five diseases for rice grown anywhere in the world for years from 1983 to near current using `get_wth()` to fetch data from the [NASA POWER web API](https://power.larc.nasa.gov).
Alternatively, you can supply your own weather data for any time period as long as it fits the model’s requirements.

{epicrop} is not yet on CRAN. You can install it this way.

```{r eval=FALSE}
if (!require("remotes"))
install.packages("remotes")
remotes::install_github("adamhsparks/epicrop",
build_vignettes = TRUE
)
```

## Get weather data

First you need to provide weather data for the model; {epicrop} provides the `get_wth()` function to do this.
Using it you can fetch weather data for any place in the world from 1983 to near present by providing the and latitude and dates or length of rice growing season as shown below.

```{r weather}
library("epicrop")

# Fetch weather for year 2000 wet season for a 120 day rice variety at the IRRI
# Zeigler Experiment Station
wth <- get_wth(
lonlat = c(121.25562, 14.6774),
dates = "2000-07-01",
duration = 120
)

wth
```

## Modelling bacterial blight disease intensity

Once you have the weather data, run the model for any of the five rice diseases by providing the emergence or crop establishment date for transplanted rice.

```{r example}
bb <- predict_bacterial_blight(wth, emergence = "2000-07-01")

bb
```

Lastly, you can visualise the result of the model run.

```{r plot, fig.cap="Bacterial blight disease progress over time. Results for wet season year 2000 at IRRI Zeigler Experiment Station shown. Weather data used to run the model were obtained from the NASA Langley Research Center POWER Project funded through the NASA Earth Science Directorate Applied Science Program.",}
library("ggplot2")

ggplot(data = bb,
aes(x = dates,
y = intensity)) +
labs(y = "Intensity",
x = "Date") +
geom_line() +
geom_point() +
theme_classic()
```

# Meta

- Please [report any issues or bugs](https://github.com/adamhsparks/epicrop/issues).

- License: GPL-3

- To cite {epicrop}, please use the output from `citation(package = "epicrop")`.

## Code of Conduct

Please note that the epicrop project is released with a [Contributor Code of Conduct](http://adamhsparks.github.io/epicrop/CODE_OF_CONDUCT.html).
By contributing to this project, you agree to abide by its terms.

# References

Robert J. Hijmans, Serge Savary, Rene Pangga and Jorrel Aunario. (2009). Simulation modeling of crops and their diseases. R package version 0.2-6.

Serge Savary, Andrew Nelson, Laetitia Willocquet, Ireneo Pangga and Jorrel Aunario.(2012). Modeling and mapping potential epidemics of rice diseases globally. _Crop Protection_, Volume 34, Pages 6-17, ISSN 0261-2194 DOI: [10.1016/j.cropro.2011.11.009](https://doi.org/10.1016/j.cropro.2011.11.009).

Serge Savary, Stacia Stetkiewicz, François Brun, and Laetitia Willocquet. Modelling and Mapping Potential Epidemics of Wheat Diseases-Examples on Leaf Rust and Septoria Tritici Blotch Using EPIWHEAT. (2015). _European Journal of Plant Pathology_ 142, no. 4:771–90. DOI: [10.1007/s10658-015-0650-7](https://doi.org/10.1007/s10658-015-0650-7).

Adam Sparks (2018). nasapower: A NASA POWER Global Meteorology, Surface Solar Energy and Climatology Data Client for R. _Journal of Open Source Software_, 3(30), 1035, DOI: [10.21105/joss.01035](https://doi.org/10.21105/joss.01035).

Adam Sparks (2021). _nasapower: NASA-POWER Data from R_. DOI: [10.5281/zenodo.1040727](https://doi.org/10.5281/zenodo.1040727), R package version 4.0.0, URL:
[https://CRAN.R-project.org/package=nasapower](https://CRAN.R-project.org/package=nasapower).

Jan C. Zadoks. (1971). Systems Analysis and the Dynamics of Epidemics. _Phytopathology_ 61:600. DOI: [10.1094/Phyto-61-600](https://doi.org/10.1094/Phyto-61-600).