{"id":13721613,"url":"https://github.com/FZJ-IEK3-VSA/glaes","last_synced_at":"2025-05-07T14:30:36.685Z","repository":{"id":61712615,"uuid":"114907468","full_name":"FZJ-IEK3-VSA/glaes","owner":"FZJ-IEK3-VSA","description":"Geospatial Land Availability for Energy Systems","archived":false,"fork":false,"pushed_at":"2025-03-25T12:45:19.000Z","size":11179,"stargazers_count":53,"open_issues_count":7,"forks_count":25,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-10T06:04:41.752Z","etag":null,"topics":["energy","geospatial","geospatial-analysis","python","renewable-energy"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FZJ-IEK3-VSA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-20T16:19:36.000Z","updated_at":"2025-03-25T12:45:23.000Z","dependencies_parsed_at":"2024-04-06T16:00:25.256Z","dependency_job_id":"3249a3c2-2e4a-4451-bed4-0898b0d0d735","html_url":"https://github.com/FZJ-IEK3-VSA/glaes","commit_stats":{"total_commits":155,"total_committers":12,"mean_commits":"12.916666666666666","dds":0.6064516129032258,"last_synced_commit":"e5ea5c3742308e73baeac6094834bf8dff77940a"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FZJ-IEK3-VSA%2Fglaes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FZJ-IEK3-VSA%2Fglaes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FZJ-IEK3-VSA%2Fglaes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FZJ-IEK3-VSA%2Fglaes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FZJ-IEK3-VSA","download_url":"https://codeload.github.com/FZJ-IEK3-VSA/glaes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248356510,"owners_count":21090229,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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"}},"keywords":["energy","geospatial","geospatial-analysis","python","renewable-energy"],"created_at":"2024-08-03T01:01:19.296Z","updated_at":"2025-05-07T14:30:36.653Z","avatar_url":"https://github.com/FZJ-IEK3-VSA.png","language":"Python","funding_links":[],"categories":["Energy System Assessment","Energy Systems"],"sub_categories":["Optimization","Energy System Modeling Frameworks"],"readme":"\u003ca href=\"https://www.fz-juelich.de/en/iek/iek-3\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/OfficialCodexplosive/README_Assets/862a93188b61ab4dd0eebde3ab5daad636e129d5/FJZ_IEK-3_logo.svg\" alt=\"FZJ Logo\" width=\"300px\"\u003e\u003c/a\u003e\n\n# Geospatial Land Availability for Energy Systems (GLAES)\n\nGLAES is a framework for conducting land eligibility analyses and is designed to easily incorporate disparate geospatial information from a variety of sources into a unified solution.\nCurrently, the main purpose of GLAES is performing land eligibility (LE) analyses which, in short, are used to determine which areas within a region are deemed 'eligible' for some purpose (such as placing a wind turbine).\nAlthough initially intended to operate in the context of distributed renewable energy systems, such as onshore wind and open-field solar parks, the work flow of GLAES is applicable to any context where a constrained indication of land is desired.\nExcept in the context of Europe, GLAES only provides a framework for conducting these types of analyses, and so the underlying data sources which are used will need to be provided.\nFortunately, GLAES is built on top of the Geospatial Data Abstraction Library (\u003ca href=\"https://www.gdal.org\"\u003eGDAL\u003c/a\u003e) and so is capable of incorporating information from any geospatial dataset which GDAL can interpret; including common GIS formats such as .shp and .tif files.\nIn this way, GLAES affords a high degree of flexibility such that very specific considerations, while still maintaining a consistent application method between studies.\n\n[![DOI](https://zenodo.org/badge/114907468.svg)](https://zenodo.org/badge/latestdoi/114907468)\n\n## Features\n\n- Standardized approach to land eligibility analyses\n- Applicable in any geographic region and at any resolution\n- Can flexibly incorporate most geospatial datasets: including the common .shp and .tif formats\n- Simple visualization and storage of results as common image or raster dataset\n- Simple integration of results into other analysis (via numpy array)\n\n## European Priors\n\nA number of precomputed (Prior) datasets which constitute the most commonly considered criteria used for LE analyses have been constructed for the European context.\nThese datasets are formatted to be used directly with the GLAES framework and, in doing so, drastically reduce the time requirements, data management, and overall complexity of conducting these analyses.\nThe Priors also have the added benefit of providing a common data source to all LE researchers, which further promotes consistency between independent LE evaluations.\nMost important, usage of these datasets is just as easy as applying exclusions from other geospatial datasources.\nAlthough the Prior datasets are not included when cloning this repository, they can be downloaded from [Mendeley Data](https://data.mendeley.com/datasets/trvfb3nwt2) and installed by unzipping (or placing if downloaded one-by-one) the files in the repo directory `glaes/data/priors`.\n\n---\n\n## Example\n\n### A simple LE work flow using GLAES would go as follows:\n\nObjective:\n\n- Determine land eligibility for photovoltaic (PV) modules in the \u003ca href=\"https://en.wikipedia.org/wiki/Aachen_(district)\"\u003eAachen administration region\u003c/a\u003e considering that...\n  1. PV modules should not cover agricultural areas (because people need to eat)\n  2. PV modules should not be within 200 meters of a major road way (because they may get dirty)\n  3. PV modules should not be within 1000 meters of a settlement area (because they are too shiny)\n\n```python\n    ec = ExclusionCalculator(aachenRegion, srs=3035, pixelSize=100)\n    ec.excludePrior(\"agriculture_proximity\", value=0)\n    ec.excludePrior(\"settlement_proximity\", value=(None,1000))\n    ec.excludePrior(\"roads_main_proximity\", value=(None,200))\n    ec.draw()\n```\n\n\u003cimg src=\"images/example_04.png\" alt=\"Final eligibility result\" width=\"700px\"\u003e\n\n### More Examples\n\n1. [Basic Workflow](Examples/00_basic_workflow.ipynb)\n2. [Placement Algorithm](Examples/01_Placement_algorithm.ipynb)\n\n---\n\n## Installation\n\n### Recommended installation\n\nThe recommended way to install GLAES is to use the conda-package manager. This will ensure that all dependancies are installed correctly and that the package is compatible with your system.\n\nUsing the conda package manager of your choice (we recommend [mambaforge](https://github.com/conda-forge/miniforge)), you can install GLAES with the following command:\n\n```bash\nconda install -c conda-forge glaes\n```\n\nIf you are installing GLAES into an environment using an environment.yml file, make sure to add the conda-forge channel to the file:\n\n```yaml\nchannels:\n  - conda-forge\n  - defaults\ndependencies:\n  - conda-forge::glaes\n```\n\nHowever, we **highly recommend** that you install the package into a new, empty environment, as the dependancies of GLAES may conflict with other packages you have installed. We currently working on a new release which will be compatible with later versions of GDAL (\u003e3.0).\n\n### Alternative installation\n\nThe primary dependancies of GLAES are:\n\n1. gdal\u003e2.0.0,\u003c3.0.0\n2. \u003ca href=\"https://github.com/FZJ-IEK3-VSA/geokit\"\u003eGeoKit\u003c/a\u003e \u003e= 1.2.4\n\nIf you can install these modules on you own, then the glaes module should be easily installable with:\n\n```\npip install git+https://github.com/FZJ-IEK3-VSA/glaes.git#egg=glaes\n```\n\nIf, on the otherhand, you prefer an automated installation using Anaconda, then you should be able to follow these steps:\n\n1. First clone a local copy of the repository to your computer, and move into the created directory\n\n```\ngit clone https://github.com/FZJ-IEK3-VSA/glaes.git\ncd glaes\n```\n\n1. (Alternative) If you want to use the 'dev' branch (or another branch) then use:\n\n```\ngit checkout dev\n```\n\n2. GLAES should be installable to a new environment with:\n\n```\nconda env create --file requirements.yml\n```\n\n2. (Alternative) Or into an existing environment with:\n\n```\nconda env update --file requirements.yml -n \u003cENVIRONMENT-NAME\u003e\n```\n\n2. (Alternative) If you want to install GLAES in editable mode, and also with jupyter notebook and with testing functionalities use:\n\n```\nconda env create --file requirements-dev.yml\n```\n\n---\n\n## Associated papers\n\nIf you would like to see a **much** more detailed discussion on land eligibility analysis and see why a framework such as GLAES is not only helpful, but a requirement, please see:\n\n\u003ca href=\"https://www.mdpi.com/1996-1073/11/5/1246#B21-energies-11-01246\"\u003eThe Background Paper\u003c/a\u003e\n\nExamples of Land Eligibility evaluation and applications:\n\n- [Uniformly constrained land eligibility for onshore European wind power](https://doi.org/10.1016/j.renene.2019.06.127)\n\n- [The techno-economic potential of offshore wind energy with optimized future turbine designs in Europe](https://doi.org/10.1016/j.apenergy.2019.113794)\n\n- [Linking the Power and Transport Sectors—Part 2: Modelling a Sector Coupling Scenario for Germany](http://www.mdpi.com/1996-1073/10/7/957/htm)\n\n---\n\n## Example applications of external institutions\n\n- [Cost-potential curves of onshore wind energy including disamenity costs](https://link.springer.com/article/10.1007/s10640-022-00746-2) \n\n---\n  \n## Citation\n\nIf you decide to use GLAES anywhere in a published work, please kindly cite us using the following\n\n```bibtex\n@article{Ryberg2018,\n  author = {Ryberg, David and Robinius, Martin and Stolten, Detlef},\n  doi = {10.3390/en11051246},\n  issn = {1996-1073},\n  journal = {Energies},\n  month = {may},\n  number = {5},\n  pages = {1246},\n  title = {{Evaluating Land Eligibility Constraints of Renewable Energy Sources in Europe}},\n  url = {http://www.mdpi.com/1996-1073/11/5/1246},\n  volume = {11},\n  year = {2018}\n}\n```\n\n---\n\n## License\n\nMIT License\n\nCopyright (c) 2017-2022 David Severin Ryberg (FZJ IEK-3), Jochen Linßen (FZJ IEK-3), Martin Robinius (FZJ IEK-3), Detlef Stolten (FZJ IEK-3)\n\nYou should have received a copy of the MIT License along with this program.  \nIf not, see \u003chttps://opensource.org/licenses/MIT\u003e\n\n## About Us\n\u003cp align=\"center\"\u003e\u003ca href=\"https://www.fz-juelich.de/en/iek/iek-3\"\u003e\u003cimg src=\"https://github.com/OfficialCodexplosive/README_Assets/blob/master/iek3-wide.png\" alt=\"Institut TSA\"\u003e\u003c/a\u003e\u003c/p\u003e\nWe are the \u003ca href=\"https://www.fz-juelich.de/en/iek/iek-3\"\u003eInstitute of Energy and Climate Research - Techno-economic Systems Analysis (IEK-3)\u003c/a\u003e belonging to the \u003ca href=\"https://www.fz-juelich.de/en\"\u003eForschungszentrum Jülich\u003c/a\u003e. Our interdisciplinary department's research is focusing on energy-related process and systems analyses. Data searches and system simulations are used to determine energy and mass balances, as well as to evaluate performance, emissions and costs of energy systems. The results are used for performing comparative assessment studies between the various systems. Our current priorities include the development of energy strategies, in accordance with the German Federal Government’s greenhouse gas reduction targets, by designing new infrastructures for sustainable and secure energy supply chains and by conducting cost analysis studies for integrating new technologies into future energy market frameworks.\n\n## Acknowledgment\n\nThis work was supported by the Helmholtz Association under the Joint Initiative [\"Energy System 2050 – A Contribution of the Research Field Energy\"](https://www.helmholtz.de/en/research/energy/energy_system_2050/).\n\n\u003ca href=\"https://www.helmholtz.de/en/\"\u003e\u003cimg src=\"https://www.helmholtz.de/fileadmin/user_upload/05_aktuelles/Marke_Design/logos/HG_LOGO_S_ENG_RGB.jpg\" alt=\"Helmholtz Logo\" width=\"200px\" style=\"float:right\"\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFZJ-IEK3-VSA%2Fglaes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFZJ-IEK3-VSA%2Fglaes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFZJ-IEK3-VSA%2Fglaes/lists"}