This repository contains analysis and support scripts used for modeling the prevalence of malaria (P. falciparum) in various countries using the main malarial simulation. Generally the code is organized with the assumption that most scripts will be written in Python; however, a subdirectory for Matlab code is included which contains some useful functions for plotting various data points from the simulation related to calibration and validation.
The main repository for the simulation can be found at rjzupko/PSU-CIDD-Malaria-Simulation or maciekboni/PSU-CIDD-Malaria-Simulation.
/ - The root directory contains scripts that may be run from the command line that of use with the simulation.
bash/ - This directory contains Bash scripts as well as job files that may be manipulated by the Bash scripts to run replicates on the Roar Supercomputer.
earthengine/ - This directory contains scripts intended for use with Google Earth Engine.
matlab/ - This directory contains Matlab functions that can be used to generate plots for various comparison points used for model calibration and validation.
python/ - This directory contains the Python scripts that invoked by the bash scripts in the root directory of this repository.
python/include/ - This directory contains Python scripts that contain shared code and cannot be run on their own.
.pep8speaks.yml - Configuration file for pep8speaks which uses codes from pycodestyle.
The following dependencies need to be installed for all of the Python scripts to operate and can be installed individually on most systems via pip install:
- jenkspy: https://pypi.org/project/jenkspy/
- numpy : https://pypi.org/project/numpy/
Or, all the dependencies can be installed via pip install using the Python/requirements.txt file:
pip install -r requirements.txtIn order to user the local beta calibration and replicate execution functionality task-spooler will need to be installed:
sudo apt install task-spoolerThe MATLAB calibration validation scripts require the Signal Processing Toolbox be installed and were last updated with MATLAB R2021b.
Presently these scripts are only tested to run on Linux or Windows vis the Windows Subsystem for Linux. In order to run these scripts you will first need to git clone the repository to your local computer. Once cloned you can access them by adding them to the PATH variable:
Per Session, from the root of the repository
PATH=$PATH:`pwd`Via Configuration
- Open
.bashrc(vi ~/.bashrc) - Add the line
PATH=$PATH:path_to_repositorywherepath_to_repositoryis the full path to the root of the repository. - Save and close
- Reload
.bashrc(source ~/.bashrc)
Adam Auton (2021). Red Blue Colormap (https://www.mathworks.com/matlabcentral/fileexchange/25536-red-blue-colormap), MATLAB Central File Exchange. Retrieved August 9, 2021.