FoodClim is a NetLogo model for simulating and visualizing how food yield responds to different climate conditions. It is designed to support empirically grounded agent-based models on food systems and to improve the reproducibility of simulations by enabling parallel execution alongside other models.

The model runs in parallel with the LogoClim model, which provides climate data from WorldClim 2.1.

If you find this project useful, please consider giving it a star!  

Refer to the LogoClim installation guide for detailed steps on installing the required dependencies.

Once LogoClim is installed, you can run the FoodClim model by specifying the path to your LogoClim installation in the FoodClim interface. This allows FoodClim to access climate data provided by LogoClim during simulations.

Refer to the Info tab in the model for additional details.

FoodClim can be integrated with other models using the LevelSpace (ls) extension for NetLogo. LevelSpace enables parallel execution and communication between multiple models. This approach supports more comprehensive simulations and facilitates the study of complex interactions between food systems and environmental processes.

If you use this model in your research, please cite it to acknowledge the effort invested in its development and maintenance. Your citation helps support the ongoing improvement of the model.

To cite FoodClim in publications please use the following format:

Vartanian, D., Garcia, L., & Carvalho, A. M. (2025). FoodClim: Food yield responses to climate change in NetLogo [Computer software]. https://doi.org/10.17605/OSF.IO/ZGVMP

A BibTeX entry for LaTeX users is:

@Misc{vartanian2025,
  title = {FoodClim: Food yield responses to climate change in NetLogo},
  author = {{Daniel Vartanian} and {Leandro Garcia} and {Aline Martins de Carvalho}},
  year = {2025},
  doi = {https://doi.org/10.17605/OSF.IO/ZGVMP},
  note = {NetLogo model}
}

Contributions are welcome! Whether you want to report bugs, suggest features, or improve the code or documentation, your input is highly valued.

When contributing code, please follow the tidy design principles and the tidyverse style guide whenever possible.

You can also support the development of FoodClim by becoming a sponsor. Click here to make a donation. Please mention FoodClim in your donation message.

Copyright (C) 2025 Daniel Vartanian

FoodClim is free software: you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see <https://www.gnu.org/licenses/>.

We gratefully acknowledge Stephen E. Fick, Robert J. Hijmans, and the entire WorldClim team for their outstanding work in creating and maintaining the WorldClim datasets, which form the foundation of this project.

We thank the Climatic Research Unit at the University of East Anglia and the United Kingdom's Met Office for developing and providing access to the CRU-TS-4.09 dataset, a vital source of historical climate data.

We also acknowledge the World Climate Research Programme (WCRP), its Working Group on Coupled Modelling, and the Coupled Model Intercomparison Project Phase 6 (CMIP6) for coordinating and advancing global climate model development.

We are grateful to the climate modeling groups for producing and sharing their model outputs, the Earth System Grid Federation (ESGF) for archiving and providing access to the data, and the many funding agencies that support CMIP6 and ESGF.