{"id":337339,"name":"LogoClim","description":"Allows researchers to integrate high-resolution climate data into agent-based models, supporting reproducible research in ecology, agriculture, environmental sciences, and other fields that rely on climate data.","url":"https://github.com/sustentarea/logoclim","last_synced_at":"2026-04-14T13:30:18.460Z","repository":{"id":287378081,"uuid":"857088572","full_name":"sustentarea/logoclim","owner":"sustentarea","description":"⛅ WorldClim in NetLogo","archived":false,"fork":false,"pushed_at":"2026-02-26T21:09:04.000Z","size":217518,"stargazers_count":18,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-03T13:37:26.337Z","etag":null,"topics":["agent-based-modeling","climate-change","climate-data-visualization","cmip6","complex-systems","complexity-science","environmental-sciences","future-climate-scenarios","geospatial-analysis","historical-climate-data","levelspace","logonia","netlogo","parallel-execution","reproducible-research","shared-socioeconomic-pathways","simulations","spatial-analysis","time-series","worldclim"],"latest_commit_sha":null,"homepage":"https://sustentarea.github.io/logoclim/","language":"NetLogo","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sustentarea.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":"codemeta.json","zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["danielvartan"]}},"created_at":"2024-09-13T19:25:35.000Z","updated_at":"2026-02-26T21:03:11.000Z","dependencies_parsed_at":"2025-12-29T12:10:05.218Z","dependency_job_id":"874d3ad7-84c0-4398-b763-a3934439c1e7","html_url":"https://github.com/sustentarea/logoclim","commit_stats":null,"previous_names":["sustentarea/logoclim"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/sustentarea/logoclim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sustentarea%2Flogoclim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sustentarea%2Flogoclim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sustentarea%2Flogoclim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sustentarea%2Flogoclim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sustentarea","download_url":"https://codeload.github.com/sustentarea/logoclim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sustentarea%2Flogoclim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31679484,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-11T08:18:19.405Z","status":"ssl_error","status_checked_at":"2026-04-11T08:17:08.892Z","response_time":54,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"owner":{"login":"sustentarea","name":"Sustentarea","uuid":"171078414","kind":"organization","description":"Research and Extension Center at the University of São Paulo (USP)","email":"sustentarea@usp.br","website":"https://www.fsp.usp.br/sustentarea","location":"Brazil","twitter":null,"company":null,"icon_url":"https://avatars.githubusercontent.com/u/171078414?v=4","repositories_count":1,"last_synced_at":"2024-05-29T10:59:20.000Z","metadata":{"has_sponsors_listing":false},"html_url":"https://github.com/sustentarea","funding_links":[],"total_stars":0,"followers":2,"following":0,"created_at":"2024-05-29T10:59:20.601Z","updated_at":"2024-05-29T10:59:20.601Z","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sustentarea","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sustentarea/repositories"},"packages":[],"commits":{"id":9652271,"full_name":"sustentarea/logoclim","default_branch":"master","total_commits":208,"total_committers":2,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":104.0,"dds":0.004807692307692291,"past_year_total_commits":195,"past_year_total_committers":2,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":97.5,"past_year_dds":0.00512820512820511,"last_synced_at":"2026-04-11T12:01:30.405Z","last_synced_commit":"ca1a79768728083b7edc8d71412bf42a68b33c8a","created_at":"2025-04-12T07:39:44.519Z","updated_at":"2026-04-11T12:01:30.364Z","committers":[{"name":"Daniel Vartanian","email":"danielvartan@proton.me","login":"danielvartan","count":207},{"name":"Leandro Garcia","email":"l.garcia@qub.ac.uk","login":"leandromtg","count":1}],"past_year_committers":[{"name":"Daniel Vartanian","email":"danielvartan@proton.me","login":"danielvartan","count":194},{"name":"Leandro Garcia","email":"l.garcia@qub.ac.uk","login":"leandromtg","count":1}],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories/sustentarea%2Flogoclim/commits","host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-13T00:00:06.408Z","repositories_count":6212804,"commits_count":903776929,"contributors_count":34930548,"owners_count":1144009,"icon_url":"https://github.com/github.png","host_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories"}},"issues_stats":{"full_name":"sustentarea/logoclim","html_url":"https://github.com/sustentarea/logoclim","last_synced_at":"2026-03-01T16:00:54.833Z","status":"active","issues_count":15,"pull_requests_count":1,"avg_time_to_close_issue":6951923.7272727275,"avg_time_to_close_pull_request":null,"issues_closed_count":11,"pull_requests_closed_count":0,"pull_request_authors_count":1,"issue_authors_count":3,"avg_comments_per_issue":5.133333333333333,"avg_comments_per_pull_request":0.0,"merged_pull_requests_count":0,"bot_issues_count":0,"bot_pull_requests_count":0,"past_year_issues_count":15,"past_year_pull_requests_count":1,"past_year_avg_time_to_close_issue":6951923.7272727275,"past_year_avg_time_to_close_pull_request":null,"past_year_issues_closed_count":11,"past_year_pull_requests_closed_count":0,"past_year_pull_request_authors_count":1,"past_year_issue_authors_count":3,"past_year_avg_comments_per_issue":5.133333333333333,"past_year_avg_comments_per_pull_request":0.0,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":0,"past_year_merged_pull_requests_count":0,"created_at":"2025-04-12T07:39:44.596Z","updated_at":"2026-03-01T16:00:54.833Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/sustentarea%2Flogoclim","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/sustentarea%2Flogoclim/issues","issue_labels_count":{"enhancement":8,"documentation":6},"pull_request_labels_count":{},"issue_author_associations_count":{"NONE":8,"MEMBER":7},"pull_request_author_associations_count":{"COLLABORATOR":1},"issue_authors":{"danielvartan":7,"platipodium":5,"jamesdamillington":3},"pull_request_authors":{"leandromtg":1},"host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-07T00:00:09.463Z","repositories_count":14123892,"issues_count":34523031,"pull_requests_count":112714654,"authors_count":11228463,"icon_url":"https://github.com/github.png","host_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories","owners_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/owners","authors_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors"},"past_year_issue_labels_count":{"enhancement":8,"documentation":6},"past_year_pull_request_labels_count":{},"past_year_issue_author_associations_count":{"NONE":8,"MEMBER":7},"past_year_pull_request_author_associations_count":{"COLLABORATOR":1},"past_year_issue_authors":{"danielvartan":7,"platipodium":5,"jamesdamillington":3},"past_year_pull_request_authors":{"leandromtg":1},"maintainers":[{"login":"danielvartan","count":7,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/danielvartan"},{"login":"leandromtg","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/leandromtg"}],"active_maintainers":[{"login":"danielvartan","count":7,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/danielvartan"},{"login":"leandromtg","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/leandromtg"}]},"events":{"total":{"ReleaseEvent":4,"MemberEvent":1,"PullRequestEvent":1,"IssuesEvent":18,"WatchEvent":12,"IssueCommentEvent":29,"PushEvent":113,"PublicEvent":1,"CreateEvent":6},"last_year":{"ReleaseEvent":4,"MemberEvent":1,"PullRequestEvent":1,"IssuesEvent":18,"WatchEvent":12,"IssueCommentEvent":29,"PushEvent":111,"CreateEvent":6}},"keywords":["agent-based-modeling","climate-change","climate-data-visualization","cmip6","complex-systems","complexity-science","environmental-sciences","future-climate-scenarios","geospatial-analysis","historical-climate-data","levelspace","logonia","netlogo","parallel-execution","reproducible-research","shared-socioeconomic-pathways","simulations","spatial-analysis","time-series","worldclim"],"dependencies":[{"ecosystem":"actions","filepath":".github/workflows/publish.yaml","sha":null,"kind":"manifest","created_at":"2025-09-13T11:34:05.460Z","updated_at":"2025-09-13T11:34:05.460Z","repository_link":"https://github.com/sustentarea/logoclim/blob/main/.github/workflows/publish.yaml","dependencies":[{"id":25127961835,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v4","direct":true,"kind":"composite","optional":false},{"id":25127961836,"package_name":"softprops/action-gh-release","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/check-netlogo.yaml","sha":null,"kind":"manifest","created_at":"2025-12-29T12:10:05.011Z","updated_at":"2025-12-29T12:10:05.011Z","repository_link":"https://github.com/sustentarea/logoclim/blob/main/.github/workflows/check-netlogo.yaml","dependencies":[{"id":25781033423,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v4","direct":true,"kind":"composite","optional":false},{"id":25781033424,"package_name":"actions/cache","ecosystem":"actions","requirements":"v4","direct":true,"kind":"composite","optional":false},{"id":25781033425,"package_name":"danielvartan/netlogo-actions/setup-netlogo","ecosystem":"actions","requirements":"v1","direct":true,"kind":"composite","optional":false},{"id":25781033426,"package_name":"danielvartan/netlogo-actions/check-netlogo","ecosystem":"actions","requirements":"v1","direct":true,"kind":"composite","optional":false}]}],"score":3.7841896339182615,"created_at":"2025-12-09T00:21:25.353Z","updated_at":"2026-04-14T13:30:18.465Z","avatar_url":"https://github.com/sustentarea.png","language":"NetLogo","category":"Climate Change","sub_category":"Climate Data Access and Visualization","monthly_downloads":0,"total_dependent_repos":0,"total_dependent_packages":0,"readme":"# LogoClim \u003cimg src=\"images/logo.svg\" align=\"right\" width=\"120\" /\u003e\n\n\u003c!-- quarto render --\u003e\n\n\u003c!-- badges: start --\u003e\n[![JOSS journal\nbadge](https://joss.theoj.org/papers/093e7333c6a34b5f3dc0b44b76e05480/status.svg)](https://joss.theoj.org/papers/093e7333c6a34b5f3dc0b44b76e05480)\n[![Project Status: Active - The project has reached a stable, usable\nstate and is being actively\ndeveloped.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n[![CoMSES Network\nbadge](https://img.shields.io/badge/CoMSES%20Network-2.1.0-1284C5.svg)](https://www.comses.net/codebases/bccd451f-76a4-408a-85fd-c5024359ba9a/)\n[![OSF DOI\nbadge](https://img.shields.io/badge/doi-10.17605/OSF.IO/EAPZU-1284C5.svg)](https://doi.org/10.17605/OSF.IO/EAPZU)\n[![Check NetLogo workflow\nbadge](https://github.com/sustentarea/logoclim/workflows/check-netlogo.yaml/badge.svg)](https://github.com/sustentarea/logoclim/actions)\n[![Render manual workflow\nbadge](https://github.com/sustentarea/logoclim/workflows/render-manual.yaml/badge.svg)](https://github.com/sustentarea/logoclim/actions)\n[![fair-software.eu](https://img.shields.io/badge/fair--software.eu-%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F-green)](https://fair-software.eu)\n[![FAIR checklist\nbadge](https://img.shields.io/badge/fairsoftwarechecklist.net--00a7d9)](https://fairsoftwarechecklist.net/v0.2?f=31\u0026a=30112\u0026i=32301\u0026r=123)\n[![GNU GPLv3\nlicense](https://img.shields.io/badge/license-GPLv3-bd0000.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Contributor Covenant 3.0 code of conduct\nbadge](https://img.shields.io/badge/Contributor%20Covenant-3.0-4baaaa.svg)](https://www.contributor-covenant.org/version/3/0/code_of_conduct/)\n\u003c!-- badges: end --\u003e\n\n## Overview\n\n`LogoClim` is a [NetLogo](https://www.netlogo.org) model designed to\nsimulate and visualize global climate conditions. It allows researchers\nto pull high-resolution climate data directly into agent-based models,\nmaking it easier to study how climate variables interact with complex\nsystems over time.\n\nLearn more about the model in the [user\nmanual](https://sustentarea.github.io/logoclim/).\n\n\u003e If you find this project useful, please consider giving it a star!  \n\u003e [![GitHub repo\n\u003e stars](https://img.shields.io/github/stars/sustentarea/logoclim)](https://github.com/sustentarea/logoclim/)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/logoclim-interface.gif\" /\u003e\n\u003c/p\u003e\n\n\u003e [!NOTE]\n\u003e `LogoClim` is an independent project with no affiliation to [WorldClim](https://worldclim.org/) 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](https://worldclim.org/about.html).\n\n## How It Works\n\n`LogoClim` uses raster data to represent climate variables such as\ntemperature and precipitation over time. It incorporates historical data\n(1951-2024) and future climate projections (2021-2100) derived from\n[global climate\nmodels](https://www.climatehubs.usda.gov/hubs/northwest/topic/basics-global-climate-models)\nunder various Shared Socioeconomic Pathways\n([SSPs](https://climatedata.ca/resource/understanding-shared-socio-economic-pathways-ssps/),\n[O’Neill et al.,\n2017](https://doi.org/10.1016/j.gloenvcha.2015.01.004)).\n\nThe model operates on a grid of patches, where each patch represents a\ngeographical area and stores values for latitude, longitude, and\nselected climate variables. During the simulation, patches update their\ncolors based on the data values. The results can be visualized on a map,\naccompanied by plots that display the mean, minimum, maximum, and\nstandard deviation of the selected variable over time.\n\nAll climate inputs come from [WorldClim 2.1](https://worldclim.org/), a\nwidely used source of high-resolution climate datasets based on weather\nstation observations worldwide ([Fick \u0026 Hijmans,\n2017](https://doi.org/10.1002/joc.5086)). These data series are offered\nat various spatial resolutions, ranging from 10 minutes (~340 km² at the\nequator) to 30 seconds (~1 km² at the equator), and can be chosen within\nthe model interface.\n\n### Historical Climate Data\n\nThis [series](https://www.worldclim.org/data/worldclim21.html) includes\nonly 12 monthly data points representing long-term average climate\nconditions for the period 1970-2000. It provides averages on minimum,\nmean, and maximum temperature, precipitation, solar radiation, wind\nspeed, vapor pressure, elevation, and on [bioclimatic\nvariables](https://www.worldclim.org/data/bioclim.html).\n\n### Historical Monthly Weather Data\n\nThis [series](https://www.worldclim.org/data/monthlywth.html) includes\n12 monthly data points for each year from 1951 to 2024, based on\n[downscaled](https://worldclim.org/data/downscaling.html) data from\n[CRU-TS-4.09](https://crudata.uea.ac.uk/cru/data/hrg/cru_ts_4.09/),\ndeveloped by the [Climatic Research\nUnit](https://www.uea.ac.uk/groups-and-centres/climatic-research-unit)\nat the [University of East Anglia](https://www.uea.ac.uk/). It provides\nmonthly averages for minimum temperature, maximum temperature, and total\nprecipitation.\n\n### Future Climate Data\n\nThis [series](https://www.worldclim.org/data/cmip6/cmip6climate.html)\nincludes 12 monthly data points from\n[downscaled](https://worldclim.org/data/downscaling.html) climate\nprojections derived from\n[CMIP6](https://www.wcrp-climate.org/wgcm-cmip/wgcm-cmip6) models for\nfour future periods: 2021-2040, 2041-2060, 2061-2080, and 2081-2100. The\nprojections cover four\n[SSPs](https://climatedata.ca/resource/understanding-shared-socio-economic-pathways-ssps/):\n126, 245, 370, and 585, with data available for average minimum\ntemperature, average maximum temperature, total precipitation, and\n[bioclimatic variables](https://www.worldclim.org/data/bioclim.html).\n\nLearn more about the data series in the\n[WorldClim](https://www.worldclim.org) website.\n\n## Usage\n\nTo get started using `LogoClim`, you must have\n[NetLogo](https://www.netlogo.org) version 7 or later installed. The\nNetLogo [website](https://www.netlogo.org) provides easy installers for\nWindows, macOS, and Linux, along with detailed instructions for\ninstallation.\n\nThe model also depends on four NetLogo extensions:\n[`GIS`](https://docs.netlogo.org/gis.html),\n[`Pathdir`](https://github.com/cstaelin/Pathdir-Extension),\n[`String`](https://github.com/NetLogo/String-Extension), and\n[`Time`](https://docs.netlogo.org/time.html). No manual installation is\nrequired since they are automatically installed the first time the model\nruns.\n\n\u003e [!TIP]\n\u003e Linux users can install NetLogo via [`LogoPak`](https://github.com/danielvartan/logopak), a [Flatpak](https://flatpak.org) package that bundles all four NetLogo applications: NetLogo, NetLogo 3D, HubNet Client, and BehaviorSearch.\n\nWith NetLogo ready, follow these 5 steps to get `LogoClim` up and\nrunning.\n\n### A. Downloading the Model\n\nYou can download the latest release of the model from the [CoMSES\nNetwork](https://www.comses.net/codebases/bccd451f-76a4-408a-85fd-c5024359ba9a/).\nThis is the recommended option for most users, as it provides a stable\nversion of the model that has been tested and documented.\n\nFor the development version, you can clone or download the model GitHub\ncode repository directly.\n\n### B. Opening the Model\n\nAfter downloading and uncompressing the model files, open the\n`logoclim.nlogox` file in NetLogo. You can find this file in the `code`\ndirectory when using the [CoMSES\nNetwork](https://www.comses.net/codebases/bccd451f-76a4-408a-85fd-c5024359ba9a/)\nrelease or in the `nlogox` folder when using the development version.\n\n### C. Preparing the Data\n\nThe [CoMSES Network\nrelease](https://www.comses.net/codebases/bccd451f-76a4-408a-85fd-c5024359ba9a/)\nincludes an example dataset that is ready to use with `LogoClim`. You\ncan use it as a starting point. But, ideally you should prepare your own\ndata to suit your research needs. The [user\nmanual](https://sustentarea.github.io/logoclim/) will guide you through\nthe process of downloading and preparing\n[WorldClim](https://www.worldclim.org/) data for use with `LogoClim`.\n\nWe also provide other example datasets for testing and demonstration.\nThese files are available in the model’s [OSF\nrepository](https://doi.org/10.17605/OSF.IO/RE95Z) and are ready to use\nwith `LogoClim`. Please note that these datasets are for demonstration\npurposes only and are not be suitable for research applications. Always\nverify the suitability of the data for your specific research questions\nand objectives.\n\n### D. Running the Model\n\nWith files at hand, use the *Select Data Directory* button in the model\ninterface to specify their location. This will set the `data-path`\nglobal variable to the correct path, allowing the model to access the\ndata. After that, you can configure the other parameters as needed and\nstart the simulation.\n\nOnce everything is set, click `Setup` and then `Go` buttons to start the\nsimulation. Learn more about the model interface and parameters in the\n[user\nmanual](https://sustentarea.github.io/logoclim/qmd/how-to-use-it.html#interface-controls).\n\nNote that the example dataset included in the [CoMSES Network\nrelease](https://www.comses.net/codebases/bccd451f-76a4-408a-85fd-c5024359ba9a/)\nis intentionally small to keep downloads fast and easy. The model’s\ndefault configuration already points to this dataset, so you can simply\nclick `Setup` and then `Go` to run the model with it.\n\n### E. Integrating with Other Models\n\n`LogoClim` was created to be integrated with other models using\nNetLogo’s\n[LevelSpace](https://ccl.northwestern.edu/netlogo/docs/ls.html)\nextension. This extension enables parallel execution and data exchange\nbetween models. See the [user\nmanual](https://sustentarea.github.io/logoclim/qmd/levelspace.html) for\nintegration instructions.\n\nTo facilitate this integration, we created the\n[`Logônia`](https://github.com/sustentarea/logonia) model, a fictional\nplant-growth model providing a practical example of how to integrate\n`LogoClim` with other models. It is also available on the [CoMSES\nNetwork](https://www.comses.net/codebases/4f2be13a-3957-4537-bf64-3fad96ba271f/)\nand its code repository is available on\n[GitHub](https://github.com/sustentarea/logonia).\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/logonia-interface.gif\" /\u003e\n\u003c/p\u003e\n\n## User Manual\n\n\u003e [!NOTE]\n\u003e This section describes the technical setup required to render the user manual locally. You do not need any of this to simply use `LogoClim`.\n\n`LogoClim`’s [user manual](https://sustentarea.github.io/logoclim/) is\ndeveloped using the latest versions of the [Quarto](https://quarto.org/)\npublishing system, the [NetLogo](https://www.netlogo.org/) environment,\nand the [R](https://www.r-project.org/) programming language. To ensure\nconsistent results, the [`renv`](https://rstudio.github.io/renv/)\npackage is used to manage and restore the R environment.\n\nTo render the manual or reproduce its analyses locally, install the four\ndependencies listed above and follow the steps below.\n\n1.  **Clone** this repository to your local machine.\n2.  **Open** the project in the terminal or in your preferred\n    [IDE](https://en.wikipedia.org/wiki/Integrated_development_environment).\n3.  **Install package dependencies** by running\n    `Rscript -e \"renv::restore()\"` in the terminal or\n    [`renv::restore()`](https://rstudio.github.io/renv/reference/restore.html)\n    in an R console. Make sure R is installed and available in your\n    system’s [PATH](https://en.wikipedia.org/wiki/PATH_(variable))\n    before running this command.\n4.  **Open** the Quarto notebook files (`.qmd`) and run the code as\n    described.\n\nWhen running\n[`renv::restore()`](https://rstudio.github.io/renv/reference/restore.html),\ncheck the output for any missing system dependencies like\n[GDAL](https://gdal.org/). They are usually installed automatically via\nyour OS package manager, but if something fails, you may need to handle\nthem manually. See\n[`render-manual.yaml`](.github/workflows/render-manual.yaml) for a list\nof system dependencies required for your operating system.\n\nWe do not recommend using external environments such as\n[Anaconda](https://www.anaconda.com/), as these can cause issues with R\npackage installation and management. This project relies on several\nsystem dependencies, all of which are automatically installed via the\nComprehensive R Archive Network ([CRAN](https://cran.r-project.org/)).\n\nWe recommend using the installers provided by the [R\nProject](https://www.r-project.org/) or the\n[`rig`](https://github.com/r-lib/rig) installation manager from\n[`r-lib`](https://github.com/r-lib) when installing R. If your\n[IDE](https://en.wikipedia.org/wiki/Integrated_development_environment)\nlacks a built-in R console, consider installing\n[`radian`](https://github.com/randy3k/radian) for a better experience.\n\nAvoid using\n[VPNs](https://en.wikipedia.org/wiki/Virtual_private_network), corporate\nproxies, or other network-routing tools while processing the data, as\nthese can interfere with the downloads.\n\nIf you run into issues with [`renv`](https://rstudio.github.io/renv/)\n(it can be [a bit of a\npain](https://youtu.be/l01u7Ue9pIQ?si=S44LlHVSufGJ4zdq) sometimes), you\ncan use\n[`renv::deactivate(clean = TRUE)`](https://rstudio.github.io/renv/reference/activate.html)\nto remove the environment completely. In that case, you will need to\ninstall all required packages manually.\n\nTo render the entire manual, run the following command in the terminal:\n\n``` bash\nquarto render --profile html\n```\n\nThe rendering process may take some time depending on your machine. Once\ncomplete, the [Quarto](https://quarto.org/) book will be available in\nthe [`docs`](docs) folder.\n\n## Contributing\n\n[![](https://img.shields.io/badge/Contributor%20Covenant-3.0-4baaaa.svg)](https://www.contributor-covenant.org/version/3/0/code_of_conduct/)\n\nContributions are always welcome! Whether you want to report bugs,\nsuggest new features, or help improve the code or documentation, your\ninput makes a difference.\n\nBefore opening a new issue, please check the [issues\ntab](https://github.com/sustentarea/logoclim/issues) to see if your\ntopic has already been reported.\n\n[![](https://img.shields.io/static/v1?label=Sponsor\u0026message=%E2%9D%A4\u0026logo=GitHub\u0026color=%23fe8e86)](https://github.com/sponsors/danielvartan)\n\nYou can also support the development of `LogoClim` by becoming a\nsponsor.\n\nClick [here](https://github.com/sponsors/danielvartan) to make a\ndonation. Please mention `LogoClim` in your donation message.\n\n## Citation\n\n[![](https://img.shields.io/badge/doi-10.17605/OSF.IO/EAPZU-1284C5.svg)](https://doi.org/10.17605/OSF.IO/EAPZU)\n\n\u003e [!NOTE]\n\u003e When using WorldClim data, you must also cite the original data sources.\n\u003e\n\u003e The appropriate citation depends on the specific dataset utilized. Please refer to the [WorldClim website](https://www.worldclim.org/data/index.html#citation) for up-to-date citation guidelines and dataset references.\n\nIf you use this model in your research, please cite it to acknowledge\nthe effort invested in its development and maintenance. Your citation\nhelps support the ongoing improvement of the model.\n\nTo cite `LogoClim` in publications please use the following format:\n\nVartanian, D., Garcia, L., \u0026 Carvalho, A. M. (2026). *LogoClim:\nWorldClim in NetLogo* \\[Computer software\\].\n\u003chttps://doi.org/10.17605/OSF.IO/EAPZU\u003e\n\nA BibLaTeX entry for LaTeX users is:\n\n``` latex\n@software{vartanian2026,\n  title = {LogoClim: WorldClim in NetLogo},\n  author = {{Daniel Vartanian} and {Leandro Garcia} and {Aline Martins de Carvalho}},\n  year = {2026},\n  doi = {10.17605/OSF.IO/EAPZU}\n}\n```\n\n## License\n\n[![](https://img.shields.io/badge/license-GPLv3-bd0000.svg)](https://www.gnu.org/licenses/gpl-3.0)\n\n``` text\nCopyright (C) 2026 Sustentarea Research and Extension Center\n\nLogoClim is free software: you can redistribute it and/or modify it under the\nterms of the GNU General Public License as published by the Free Software\nFoundation, either version 3 of the License, or (at your option) any later\nversion.\n\nThis program is distributed in the hope that it will be useful, but WITHOUT ANY\nWARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A\nPARTICULAR PURPOSE. See the GNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along with\nthis program. If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n```\n\n## Acknowledgments\n\nWe gratefully acknowledge [Robert J.\nHijmans](https://orcid.org/0000-0001-5872-2872), [Stephen E.\nFick](https://orcid.org/0000-0002-3548-6966), and the entire\n[WorldClim](https://worldclim.org/) team for their outstanding work in\ncreating and maintaining the WorldClim datasets.\n\nWe thank the [Climatic Research\nUnit](https://www.uea.ac.uk/groups-and-centres/climatic-research-unit)\nat the [University of East Anglia](https://www.uea.ac.uk/) and the\nUnited Kingdom’s [Met Office](https://www.metoffice.gov.uk/) for\ndeveloping and providing access to the\n[CRU-TS-4.09](https://crudata.uea.ac.uk/cru/data/hrg/cru_ts_4.09/)\ndataset, a vital source of historical climate data.\n\nWe also acknowledge the World Climate Research Programme\n([WCRP](https://www.wcrp-climate.org/)), its Working Group on Coupled\nModelling, and the Coupled Model Intercomparison Project Phase 6\n([CMIP6](https://pcmdi.llnl.gov/CMIP6/)) for coordinating and advancing\nglobal climate model development.\n\nWe are grateful to the climate modeling groups for producing and sharing\ntheir model outputs, the Earth System Grid Federation\n([ESGF](https://esgf.llnl.gov/)) for archiving and providing access to\nthe data, and the many funding agencies that support\n[CMIP6](https://pcmdi.llnl.gov/CMIP6/) and\n[ESGF](https://esgf.llnl.gov/).\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"30%\" valign=\"center\"\u003e\n      \u003cp align=\"center\"\u003e\n        \u003ca href=\"https://www.fsp.usp.br/sustentarea/\"\u003e\n          \u003cimg src=\"images/sustentarea-logo.svg\" width=\"115\" alt=\"Sustentarea Logo\"/\u003e\n        \u003c/a\u003e\n      \u003c/p\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"70%\" valign=\"center\"\u003e\n      \u003cp\u003e\n        This work was developed with support from the \n        \u003ca href=\"https://www.fsp.usp.br/sustentarea/\"\u003eSustentarea\u003c/a\u003e\n         Research and Extension Center at the University of São Paulo (\u003ca href=\"https://www5.usp.br/\"\u003eUSP\u003c/a\u003e).\n      \u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"30%\" valign=\"center\"\u003e\n      \u003cp align=\"center\"\u003e\n        \u003ca href=\"https://resiclima.com.br/\"\u003e\n          \u003cimg src=\"images/resiclima-logo.svg\" width=\"115\" alt=\"RESICLIMA Network Logo\"/\u003e\n        \u003c/a\u003e\n      \u003c/p\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"70%\" valign=\"center\"\u003e\n      \u003cp\u003e\n        This work was developed with support from the \u003ca href=\"https://resiclima.com.br/\"\u003eResiclima Network\u003c/a\u003e, an international collaboration for the multidimensional and \n        interdisciplinary study of global climate change.\n      \u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"30%\" valign=\"center\"\u003e\n      \u003cp align=\"center\"\u003e\n        \u003ca href=\"https://www.gov.br/cnpq/\"\u003e\n          \u003cimg src=\"images/cnpq-logo.svg\" width=\"150\" alt=\"CNPq Logo\"/\u003e\n        \u003c/a\u003e\n      \u003c/p\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"70%\" valign=\"middle\"\u003e\n      \u003cp\u003e\n        This work was supported by the Department of Science and \n        Technology of the Secretariat of Science, Technology, and Innovation \n        and of the Health Economic-Industrial Complex (\u003ca href=\"https://www.gov.br/saude/pt-br/composicao/sectics/\"\u003eSECTICS\u003c/a\u003e)  of the \u003ca href=\"https://www.gov.br/saude/pt-br/composicao/sectics/\"\u003eMinistry of Health\u003c/a\u003e \n        of Brazil, and the National Council for Scientific and \n        Technological Development (\u003ca href=\"https://www.gov.br/cnpq/\"\u003eCNPq\u003c/a\u003e) (grant no. 444588/2023-0).\n      \u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n","funding_links":["https://github.com/sponsors/danielvartan"],"readme_doi_urls":["https://doi.org/10.17605/OSF.IO/EAPZU","https://doi.org/10.1016/j.gloenvcha.2015.01.004","https://doi.org/10.1002/joc.5086","https://doi.org/10.17605/OSF.IO/RE95Z"],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":[],"project_url":"https://ost.ecosyste.ms/api/v1/projects/337339","html_url":"https://ost.ecosyste.ms/projects/337339"}