Skip to content

Code and input files for a model to project acute malnutrition prevalence among children in the Gaza Strip (2023-2024) as a function of caloric intake

License

Notifications You must be signed in to change notification settings

francescochecchi/nut_cal_model_gaza

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Evolution of child acute malnutrition during war in the Gaza Strip, 2023-2024: retrospective estimates and scenario-based projections

Description of input dataset and R analysis scripts

December 2024

Funding support: UK Humanitarian Innovation Hub

General description

This repository contains data and R scripts needed to replicate the above analysis. The input datasets required are found in the \in folder, and are read automatically when the code is run. Every row in dataset sdn_cam_data_final_public.xlsx contains an individual record of a deceased person, as contained in one of three independent lists generated by the study. The Excel file also contains a variable dictionary. All the code is found in the \code folder. To replicate the analysis, follow these steps:

  • Download and unzip the repository to any folder in your computer (other than the Downloads folder, which usually gets wiped automatically). The folder is identified automatically when the code is run.
  • Download R and RStudio (see download links on [https://posit.co/download/rstudio-desktop/]). While R is sufficient to run the analysis, it is recommended to instead run the scripts from the RStudio interface.
  • Open and run the entire 00_master_code.R script (just press Alt+Ctrl+R). This will create an \out folder with further sub-folders, to which output tables and graphs will be saved automatically. As this scripts calls all the others, it alone is sufficient to replicate the analysis, but note below re: unavailability of one necessary dataset, to circumvent which we have already created an \out sub-folder in this directory, with files needed for subsequent steps.

Description of each R script

Scripts 0# : need to be run every time

  • 00_master_code.R installs or loads R packages needed for this analysis, sets general parameters and sources the other scripts in logical order. Scroll down for a representation of the inter-dependency among scripts and resulting outputs.
  • 01_functions.R contains functions needed for different steps in the analysis.
  • 02_read_prepare_inputs.R reads input data, carries out several data cleaning and management tasks and prepare objects for further analysis steps.

Scripts 1# : need to be run only once

  • 11_estimate_growth_curves.R fits additive models to Gaza growth monitoring data and estimates weight and height growth curves by sex.
  • 12_calibrate_wt_model.R estimates parameters requires to calibrate the weight model so as to accurately reproduce observed variability in growth curves.
  • 13_validate_wt_model.R tests the weight model against WHO growth standards and other sources of data.
  • 14_model_infectious_disease.R computes the relationships between period prevalence, point prevalence and incidence of ARI and diarrhoea.
  • 15_model_caloric_sacrifice.R implements a static microsimulation of households to estimate the relationship between maximum percent of caloric availabiity that adults will be willing to sacrifice, percent of children's caloric need that adults will preserve, mean caloric availability per capita and the resulting ratio of children's caloric intake under the above parameters to intake with no caloric sacrifice. Script 11 requires raw data on 2.2M growth monitoring observations from Gaza: these are not included in the repository as the file is extremely large and we do not have permission to share these data. It also requires about a day to run. Scripts 12 and 13 are dependent on first running script 11. Script 12 also requires about a day. Scripts 14 and 15 do nor require running 11, 12, and 13 and the inputs provided in the repository are sufficient. To facilitate replication, we have included in the /out subfolder all the output files from the above scripts. This enables users to implement the rest of the analysis. These outputs also enable the user to pick up the analysis from script 12. In other words, only scripy 11 is not replicable.

Scripts 2#: need to be run every time

  • 21_prepare_timeline.R prepares data on retrospective and scenario-based projections by setting up a timeline and preparing output objects.
  • 22_run_scenarios.R implements the model simulation including retrospective and scenario-based projections, as desired, gathers the results and outputs some visualisations.

Description of each input file

The input files within sub-folder \in include:

  • 03_kcal_capita_runs.rds, the output of multiple simulations to estimate caloric availability during the retrospective period of analysis. This file is an output of a separate analysis (see https://www.medrxiv.org/content/10.1101/2024.10.21.24315753v1).
  • generic_pars.xlsx, which contains several mostly metabolic parameters that should not be altered unless better data are available to the user: a description of the contents is contained within the file.
  • crisis_specs.xlsx, which contains input data, including for the retrospective and projection scenarios, specific to Gaza, as well as individual parameters. The user can vary these inputs as needed, but please refer to the description of the contents within the file.
  • crisis_specs_test_a.xlsx and crisis_specs_test_b.xlsx are versions of the above used to test the model's behaviour under different conditions, in a hypothetical population (see paper).

About the \for_paper subfolder

This sub-folder contains miscellaneous files required to set scenarios or produce visualisations for the paper, as follows:

  • 31_gaza_paper_misc.R is a script that reads the following inputs, sets assumptions of Kcal intake over time for each scenario, visualises ground GAM estimates, visualises output of test runs of the model and prepare other graphs used in various presentations of the model
  • kcal_capita_by_area_022.rds, kcal_capita_by_area_033.rds and kcal_capita_by_area_044.rds contain the outputs of sensitivity analyses of a separate paper (https://www.medrxiv.org/content/10.1101/2024.10.21.24315753v1), assuming that caloric availability in the period 6 May 2024 to 30 Sep 2024 was under-estimated by 22%, 33% and 44%, respectively. These are used to set scenario assumptions.
  • gaza_gam_ground.xlsx contains meta-data from MUAC screenings performed by various actors across Gaza.
  • gaza_ari_dis_assumptions.xlsx is not read by any script but is included for transparency: it includes scraped meta-data from surveys in Gaza that asked about ARI and diarrhoea 2-week period prevalence, and assumptions made around these surveys to inform model inputs.
  • 22_out_agg.rds is the main model output in aggregate form, needed here to create visualisations (see paper).
  • 22_out_agg_test_a.rds and 22_out_agg_test_b.rds are outputs of the model test runs under different conditions (see paper). Script 31 if self-standing and, if run, will output various graphs and files to this same sub-folder.

About

Code and input files for a model to project acute malnutrition prevalence among children in the Gaza Strip (2023-2024) as a function of caloric intake

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages