Skip to content

Commit

Permalink
Merge branch 'main' of github.com:cwhittaker1000/anopheleseasonality …
Browse files Browse the repository at this point in the history
…into main
  • Loading branch information
cwhittaker1000 committed Jan 17, 2022
2 parents aa8df28 + d8f7f23 commit a074157
Showing 1 changed file with 9 additions and 4 deletions.
13 changes: 9 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# anopheleasonality - Seasonality and Dynamics of Indian Anophelines 📈🦟

<!-- badges: start -->
[![DOI](https://zenodo.org/badge/326513361.svg)](https://zenodo.org/badge/latestdoi/326513361)
<!-- badges: end -->


## Overview
This repository contains the code used to analyse the results of a systematic review exploring the seasonality of various Anopheline species endemic to India. This review was carried out in order to identify entomological surveys in which mosquito collections had been conducted monthly (or finer resolution) over a period of at least a year.

Expand All @@ -24,15 +29,15 @@ Other than the required R packages (specified in each script), running the code
More information and details about the software and its use via R are available here: https://github.com/stan-dev/rstan/wiki/RStan-Getting-Started.

## Installation Guide and Instructions for Use
The following instructions require that all the relevant `R` packages have been installed by the user and that STAN has been installed. To replicate and reproduce the analyses presented in this paper, clone this repository and download it your local machine. Then, run the relevant set of scripts:
The following instructions require that all the relevant `R` packages have been installed by the user and that STAN has been installed. To replicate and reproduce the analyses presented in this paper, download the [Github Release](https://github.com/cwhittaker1000/anopheleseasonality/releases/tag/v1.0.0) associated with this repository. Be sure to read the intrusctions that accompany the release to ensure all the large files get placed in the right directories. Then, run the relevant set of scripts:
- Scripts in [Analyses/2_Time_Series_GP_Fitting_and_Analyses](./Analyses/2_Time_Series_GP_Fitting_and_Analyses) fit Negative Binomial Gaussian Processes to smooth the time-series, characterise their temporal properties and cluster these into dynamical archetypes.
- Scripts in [Analyses/3_Figure_Plotting](./Analyses/3_Figure_Plotting) produce the specific plots and figures present in the paper.

## Note
- This repository contains all of the datasets/outputs generated in the analyses carried out except for a small number which are larger than GitHub's maximum allowed file size. These particularly large outputs are available via the pinned Github Release associated with this repository.
- This repository contains all of the datasets/outputs generated in the analyses carried out except for a small number which are larger than GitHub's maximum allowed file size. These particularly large outputs (alongside the rest of the repo) are available for download via the pinned [Github Release](https://github.com/cwhittaker1000/anopheleseasonality/releases/tag/v1.0.0) associated with this repository.
- The fact we have included all of these files means the repository/release is **very** large - if users do not intend to reproduce all of the analyses (but are instead interested in a particular analysis e.g. the predictive mapping or the time-series clustering), only downloading the data and files relevant to the specific analysis of interest should reduce the size significantly.
- Scripts in [Analyses/1_Covariate_Extraction_and_Collation](./Analyses/1_Covariate_Extraction_and_Collation) carry out the raw processing of rainfall data (from CHIRPS via Google Earth Engine: https://developers.google.com/earth-engine/datasets/catalog/UCSB-CHG_CHIRPS_DAILY) and a suite of environmental of environmental covariates (sources for each detailed in [0_Raster_Processing.R](./Analyses/1_Covariate_Extraction_and_Collation/0_Raster_Processing.R)) specific to the location each study was carried out in. The total size of these files is >20Gb and they are not provided with the repo - if the raw files are required, they must be redownloaded from the relevant sources.
- Instead, we provide the processed versions of the rainfall data (available in [Location_Specific_CHIRPS_Rainfall](./Datasets/CHIRPS_Rainfall_Data/Location_Specific_CHIRPS_Rainfall)) and environmental variables (available via the GitHub release associated with this repository).
- Scripts in [Analyses/1_Covariate_Extraction_and_Collation](./Analyses/1_Covariate_Extraction_and_Collation) carry out the raw processing of rainfall data (from CHIRPS via Google Earth Engine: https://developers.google.com/earth-engine/datasets/catalog/UCSB-CHG_CHIRPS_DAILY) and a suite of environmental of environmental covariates (sources for each detailed in [0_Raster_Processing.R](./Analyses/1_Covariate_Extraction_and_Collation/0_Raster_Processing.R)) specific to the location each study was carried out in. The total size of these raw data files is >20Gb and they are not provided with the repo - if the raw files are required, they must be redownloaded from the relevant sources.
- Instead, we provide the processed versions of the rainfall data (available in [Location_Specific_CHIRPS_Rainfall](./Datasets/CHIRPS_Rainfall_Data/Location_Specific_CHIRPS_Rainfall)) and environmental variables (available via the [GitHub Release](https://github.com/cwhittaker1000/anopheleseasonality/releases/tag/v1.0.0) associated with this repository) specifically required to reproduce the analyses presented here.


Any issues, please post an issue on this Github repository or feel free to reach out at [email protected] 😄

0 comments on commit a074157

Please sign in to comment.