Appendix A — Release Notes

A.1 Notes

A.2 Changelog

The format is based on Keep a Changelog. The project also follows Semantic Versioning and Conventional Commits.

A.2.1 v2.2.1 (2026-07-13)

A.2.1.1 Added

  • A Zenodo DOI was created for this and future releases of the project.

A.2.1.2 Changed

  • The documentation was updated.

A.2.2 v2.2.0 (2026-07-13)

A.2.2.1 Added

  • A first draft of LogoClim User Manual, now available at https://sustentarea.github.io/logoclim. The manual is a work in progress and will be continuously updated.
  • A new color bar widget for better visualization of patch values.
  • A new global variable cell-size to store the size of each patch in degrees.
  • Automated unit tests covering most supported configurations using the check-netlogo action from the LogoActions project. Tests run on Windows, macOS, and Linux with the latest NetLogo release at each commit. Due to computational constraints, only 10m resolution settings are tested. For future climate data, only SSP-126 is included because other SSPs are not consistently available across the Global Climate Models (GCMs). GCM variations are not tested.
  • Automated unit tests on near-equality comparisons between WorldClim original files and LogoClim patch values, as well as procedure behavior tests, now included in the user manual and rendered at each commit. Tests run on Windows, macOS, and Linux with the latest NetLogo release.

A.2.2.2 Changed

  • The Bioclimatic Variable monitor was removed and is now displayed directly on the Climate Variable monitor.
  • Slider limits were adjusted and value validation for blank/empty settings was added.
  • Code of Conduct updated to Contributor Covenant 3.0.
  • All dependencies were updated to their latest versions.
  • The documentation was updated to reflect all changes.

A.2.2.3 Fixed

  • latitude/longitude inversion issue.
  • bioclimatic variables 13-18 not working when future climate data was selected.

A.2.3 v2.1.0 (2025-09-16)

A.2.3.1 Added

  • A #headless? parameter to the setup procedure for improved headless execution.
  • Two additional patch attributes: value-12 (last 12 months of values) and value-12ma (12-month moving average).
  • A 12-month moving average pen to plots, along with indicators for the start of each 12-month cycle. The y-axis now dynamically adjusts based on the minimum, maximum, and interquartile range of the 12-month data window.
  • The Logônia model as a reference for LogoClim integration.

A.2.3.2 Changed

  • The #tick and #wait parameters were removed from the go procedure; it now has no parameters, simplifying execution.
  • The go-back procedure now resets ticks and clears all plots.
  • String parameters and interface text were converted to title case.
  • The show-value procedure was improved to provide better contrast for patch labels.
  • The halt procedure was removed; error messages now provide more descriptive text.
  • Quarto notebooks were updated.
  • Documentation updated to reflect all changes.

A.2.3.3 Fixed

A.2.4 v2.0.0 (2025-07-29)

A.2.4.1 Added

  • A global variable named plot-max-y-range to optimize computations.

A.2.4.2 Changed

  • Interface widgets were resized to match the new NetLogo standard dimensions.
  • The model’s license was changed from MIT to GPLv3.

A.2.4.3 Removed

  • The transition-seconds slider, as it is no longer necessary.
  • The adjust-world-size? slider; world size adjustment is now always enabled by default.

A.2.4.4 Breaking

  • The model now requires NetLogo 7.0.1 or later.

A.2.5 v1.0.0 (2025-07-03)

First stable release! 🎉

A.2.6 v0.0.0.9015 (2025-07-02) (pre-release)

A.2.6.1 Added

  • Variations (e.g., ACCESS-ESM1-5) and additional (e.g., CanESM5) Global Climate Models (GCMs) as selectable options in global-climate-model. WorldClim provides a dedicated webpage for this data, available here.

A.2.6.2 Fixed

  • The year interval issue when using the Future Climate Data series.

A.2.7 v0.0.0.9013 (2025-06-24) (pre-release)

A.2.7.1 Added

  • adjust-world-size? slider for automatic world size adjustment.
  • Automated generation of README and LICENSE files in Quarto notebooks.

A.2.7.2 Changed

  • setup-world was improved to address bleeding issues.
  • Quarto notebooks were enhanced to fix dateline issues.
  • Unnecessary dependencies were removed and code structure was refactored for improved maintainability.
  • Documentation updated to reflect all changes.

A.2.7.3 Removed

  • All dependencies on the R programming language and its packages.
  • patch-px-size slider.
  • The automatic adjustment of start-year. An error is now raised if start-year is not set to a valid value.

A.2.7.4 Fixed

  • Persistent world bleeding is now converted to NaN values.

A.2.8 v0.0.0.9010 (2025-06-09) (pre-release)

A.2.8.1 Fixed

  • The Windows file path issue, for improved cross-platform compatibility.

A.2.9 v0.0.0.9009 (2025-06-09) (pre-release)

A.2.9.1 Changed

  • Quarto notebooks were enhanced for improved readability and clarity.
  • The codebase was refactored to increase modularity and maintainability.
  • Charts were updated to display whole numbers.
  • Documentation updated to reflect all