Skip to content
Zimbabwean Agro-Pastoral Management Model: an Agent-Based Model in NetLogo created with farmer-researchers
NetLogo R Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
CoMSESfiles
FilesForRunningOnCluster
ModelFileAndDescription
OutputDataAndAnalysisCode
README.md

README.md

ZAPMM

Zimbabwean Agro-Pastoral Management Model: Musimboti wevanhu, zvipfuo nezvirimwa. An Agent-Based Model in NetLogo created with researcher-farmers.

This model has been created with and for the researcher-farmers of the Muonde Trust (http://www.muonde.org/), a registered Zimbabwean non-governmental organization dedicated to fostering indigenous innovation. Model behaviors and parameters (mashandiro nemisiyano nedzimwe model) derive from a combination of literature review and the collected datasets from Muonde’s long-term (over 30 years) community-based research. The goals of this model are three-fold (muzvikamu zvitatu):

A) To represent three components of a Zimbabwean agro-pastoral system (crops, woodland grazing area, and livestock) along with their key interactions and feedbacks and some of the human management decisions that may affect these components and their interactions.

B) To assess how climate variation (implemented in several different ways) and human management may affect the sustainability of the system as measured by the continued provisioning of crops, livestock, and woodland grazing area.

C) To provide a discussion tool for the community and local leaders to explore different management strategies for the agro-pastoral system (hwaro/nzira yekudyidzana kwavanhu, zvipfuo nezvirimwa), particularly in the face of climate change.

If you use this code, please cite the model:

Eitzel Solera, Mv, Neves, Kleber Tulio, Solera, Jon, Wilson, Kenneth B, Mawere Ndlovu, Abraham, Fisher, Aaron C, Veski, André, Omoju, Oluwasola E, Mhike Hove, Emmanuel (2018, June 19). “Zimbabwe Agro-Pastoral Management Model (ZAPMM): Musimboti wevanhu, zvipfuo nezvirimwa.” (Version 1.0.0). CoMSES Computational Model Library. Retrieved from: https://www.comses.net/codebases/323685ea-3a71-44c1-9b95-a472a703e8cc/releases/1.0.0/

This repository includes the model code in nlogo format, the Objectives, Design, and Details (ODD) document describing the model, in .doc format. This version of the model includes timers which track setup time and run time. It also includes all the files required to run multiple BehaviorSpace Experiments (model parameter combinations) on a high-performance cloud computing cluster (using qsub). See the ODD for explanations of the behaviorspaces, which are split up for purposes of parallel computing. Finally, the repository includes the outputs of running those experiments on SabalCore Computing's cluster (http://www.sabalcore.com/) and R code analyzing the output, all of which is summarized in the ODD.

The version of the model without the timers, and the pdf version of the ODD, are here for completeness, and can also be found at CoMSES.net


Model File and Description:
---------------------------
ZAPMM-2018-06-15_WithTimers.nlogo         The version of the model with timers (used to generate results, below)
ZAPMM_ABM_ODD_2018_Final.doc              Final version of the model description document
Notes_on_Model_testing.txt                Checklist of model development/checking steps

Files for running on cluster:
-----------------------------
RunSoftwareTests.pbs             Runs the behaviorspace with the software unit tests to confirm that they pass
ShortRunForTesting.pbs           Runs a small 8-model combination to confirm that the model works on the cluster
MT_nosub.pbs                     Runs models with Muonde thresholds and no subsidy
MT_sub.pbs                       Runs models with Muonde thresholds and feed/transport subsidy for cows
OT_feed_vary_extr.pbs            Runs models with minimal thresholds, feed subsidy, and extreme rainfall models
OT_feed_vary.pbs                 Runs models with minimal thresholds, feed subsidy, and historical rainfall models
OT_nosub_const.pbs               Runs models with minimal thresholds, no subsidy/constant rainfall
OT_nosub_vary.pbs                Runs models with minimal thresholds, no subsidy, and all varying rainfall models
OT_tran_vary_extr.pbs            Runs models with minimal thresholds, transport subsidy, and extreme rainfall models
OT_tran_vary.pbs                 Runs models with minimal thresholds, transport subsidy, and historical rainfall models
email_data.sh                    Script that emails the data to the researcher
cleanup.sh                       Script that cleans up the folder after a run of the behaviorspace experiments
computer_cluster_run_notes.txt   Notes on how what was needed to set NetLogo up on SabalCore's cluster


Output data and R analysis code:
--------------------------------
ZAPMM_BehaviorTesting_2018-05-13.xls  A spreadsheet summarizing model real-time behavior checks
RunTimeSummary2018Jun15.xls           Summary spreadsheet of internal model run times and cluster run times
Exp_2018_06_15_Analysis_forGitHub.R   R script for assembling and analyzing the model output
ModelList.txt                         List of model names for input into R analysis
COWS.o* files (10)                    Output and run times for each behaviorspace run
*.dat files (10)                      Raw output from NetLogo for each behaviorspace run
Exp_2018_05_15.csv                    Results of all behaviorspaces compiled in R


Files found on CoMSES.net:
---------------------------
ZAPMM-2018-06-16.nlogo
ZAPMM_ABM_ODD_2018_Final.pdf
You can’t perform that action at this time.