LogoClim <img src="images/logo.svg" align="right" width="120" />

Overview

LogoClim is a NetLogo model designed to simulate and visualize global climate conditions. It allows researchers to pull high-resolution climate data directly into agent-based models, making it easier to study how climate variables interact with complex systems over time.

Learn more about the model in the user manual.

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

[!NOTE] LogoClim is an independent project with no affiliation to WorldClim or its developers. Users should be aware that WorldClim datasets are freely available for academic and other non-commercial use only. Any use of WorldClim data within LogoClim must comply with WorldClim's licensing terms.

How It Works

LogoClim uses raster data to represent climate variables such as temperature and precipitation over time. It incorporates historical data (1951-2024) and future climate projections (2021-2100) derived from global climate models under various Shared Socioeconomic Pathways (SSPs, O’Neill et al., 2017).

The model operates on a grid of patches, where each patch represents a geographical area and stores values for latitude, longitude, and selected climate variables. During the simulation, patches update their colors based on the data values. The results can be visualized on a map, accompanied by plots that display the mean, minimum, maximum, and standard deviation of the selected variable over time.

All climate inputs come from WorldClim 2.1, a widely used source of high-resolution climate datasets based on weather station observations worldwide (Fick & Hijmans, 2017). These data series are offered at various spatial resolutions, ranging from 10 minutes (~340 km² at the equator) to 30 seconds (~1 km² at the equator), and can be chosen within the model interface.

Historical Climate Data

This series includes only 12 monthly data points representing long-term average climate conditions for the period 1970-2000. It provides averages on minimum, mean, and maximum temperature, precipitation, solar radiation, wind speed, vapor pressure, elevation, and on bioclimatic variables.

Historical Monthly Weather Data

This series includes 12 monthly data points for each year from 1951 to 2024, based on downscaled data from CRU-TS-4.09, developed by the Climatic Research Unit at the University of East Anglia. It provides monthly averages for minimum temperature, maximum temperature, and total precipitation.

Future Climate Data

This series includes 12 monthly data points from downscaled climate projections derived from CMIP6 models for four future periods: 2021-2040, 2041-2060, 2061-2080, and 2081-2100. The projections cover four SSPs: 126, 245, 370, and 585, with data available for average minimum temperature, average maximum temperature, total precipitation, and bioclimatic variables.

Learn more about the data series in the WorldClim website.

Usage

To get started using LogoClim, you must have NetLogo version 7 or later installed. The NetLogo website provides easy installers for Windows, macOS, and Linux, along with detailed instructions for installation.

The model also depends on four NetLogo extensions: GIS, Pathdir, String, and Time. No manual installation is required since they are automatically installed the first time the model runs.

[!TIP] Linux users can install NetLogo via LogoPak, a Flatpak package that bundles all four NetLogo applications: NetLogo, NetLogo 3D, HubNet Client, and BehaviorSearch.

With NetLogo ready, follow these 5 steps to get LogoClim up and running.

A. Downloading the Model

You can download the latest release of the model from the CoMSES Network. This is the recommended option for most users, as it provides a stable version of the model that has been tested and documented.

For the development version, you can clone or download the model GitHub code repository directly.

B. Opening the Model

After downloading and uncompressing the model files, open the logoclim.nlogox file in NetLogo. You can find this file in the code directory when using the CoMSES Network release or in the nlogox folder when using the development version.

C. Preparing the Data

The CoMSES Network release includes an example dataset that is ready to use with LogoClim. You can use it as a starting point. But, ideally you should prepare your own data to suit your research needs. The user manual will guide you through the process of downloading and preparing WorldClim data for use with LogoClim.

We also provide other example datasets for testing and demonstration. These files are available in the model’s OSF repository and are ready to use with LogoClim. Please note that these datasets are for demonstration purposes only and are not be suitable for research applications. Always verify the suitability of the data for your specific research questions and objectives.

D. Running the Model

With files at hand, use the Select Data Directory button in the model interface to specify their location. This will set the data-path global variable to the correct path, allowing the model to access the data. After that, you can configure the other parameters as needed and start the simulation.

Once everything is set, click Setup and then Go buttons to start the simulation. Learn more about the model interface and parameters in the user manual.

Note that the example dataset included in the CoMSES Network release is intentionally small to keep downloads fast and easy. The model’s default configuration already points to this dataset, so you can simply click Setup and then Go to run the model with it.

E. Integrating with Other Models

LogoClim was created to be integrated with other models using NetLogo’s LevelSpace extension. This extension enables parallel execution and data exchange between models. See the user manual for integration instructions.

To facilitate this integration, we created the Logônia model, a fictional plant-growth model provid

Logoclim

Install / Use

README