# UMEP Core
## Setup
- Make sure you have a Python installation on your system
- Install `vscode` and `github` apps.
- Install `uv` package manager (e.g. `pip install uv`).
- Clone repo.
- Run `uv sync` from the directory where `pyproject.toml` in located to install `.venv` and packages.
- Select `.venv` Python environment.
- FYI: Recommended settings and extensions are included in the repo. Proceed if prompted to install extensions.
- Develop and commit to Github often!
## Demo
See the demo notebook file at [/demo.py](/demo.py).
Also, a test with GBG data is found in [/solweig_gbg_test.py](/solweig_gbg_test.py)
The demo and the test uses the datasets included in the tests folder
## Original code
The code reproduced in the `umep` folder is adapted from the original GPLv3-licensed code by Fredrik Lindberg, Ting Sun, Sue Grimmond, Yihao Tang, Nils Wallenberg.
The original code has been modified to work without QGIS to facilitate Python workflows.
The original code can be found at: [UMEP-processing](https://github.com/UMEP-dev/UMEP-processing).
This modified code is licensed under the GNU General Public License v3.0.
See the LICENSE file for details.
Please give all credit for UMEP code to the original authors and cite accordingly.
© Copyright 2018 - 2020, Fredrik Lindberg, Ting Sun, Sue Grimmond, Yihao Tang, Nils Wallenberg.
Lindberg F, Grimmond CSB, Gabey A, Huang B, Kent CW, Sun T, Theeuwes N, Järvi L, Ward H, Capel- Timms I, Chang YY, Jonsson P, Krave N, Liu D, Meyer D, Olofson F, Tan JG, Wästberg D, Xue L, Zhang Z (2018) Urban Multi-scale Environmental Predictor (UMEP) - An integrated tool for city-based climate services. Environmental Modelling and Software.99, 70-87 https://doi.org/10.1016/j.envsoft.2017.09.020
## Demo Data
Two seprated demo dataset are included
### ATENS (vector data)
#### Tree Canopies
Copernicus
#### Trees
https://walkable.cityofathens.gr/home
#### Buildings
http://gis.cityofathens.gr/layers/athens_geonode_data:geonode:c40solarmap
### Gothenburg (raster data)
Standard dataset used in tutorials (https://umep-docs.readthedocs.io/en/latest/Tutorials.html)
Raw data
{
"_id": null,
"home_page": null,
"name": "umep",
"maintainer": "UMEP Developers",
"docs_url": null,
"requires_python": "<3.14,>=3.10",
"maintainer_email": null,
"keywords": "python3, geographical-information-system, spatial-data, spatial-data-analysis, urban-climate, urban-heat-island, urban-meteorology, urban-microclimate, urban-planning, urban-sustainability, urban-thermal-comfort, urban-thermal-environment, urban-thermal-mapping, urban-thermal-modelling, urban-thermal-simulation, urban-thermal-sustainability",
"author": "UMEP Developers",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/ca/9a/76881d59519f88dd69df4a4eb961fb2a1ba1cc799eb6b826ebfca6246896/umep-0.0.1b2.tar.gz",
"platform": null,
"description": "# UMEP Core\n\n## Setup\n\n- Make sure you have a Python installation on your system\n- Install `vscode` and `github` apps.\n- Install `uv` package manager (e.g. `pip install uv`).\n- Clone repo.\n- Run `uv sync` from the directory where `pyproject.toml` in located to install `.venv` and packages.\n- Select `.venv` Python environment.\n- FYI: Recommended settings and extensions are included in the repo. Proceed if prompted to install extensions.\n- Develop and commit to Github often!\n\n## Demo\n\nSee the demo notebook file at [/demo.py](/demo.py).\n\nAlso, a test with GBG data is found in [/solweig_gbg_test.py](/solweig_gbg_test.py)\n\nThe demo and the test uses the datasets included in the tests folder\n\n## Original code\n\nThe code reproduced in the `umep` folder is adapted from the original GPLv3-licensed code by Fredrik Lindberg, Ting Sun, Sue Grimmond, Yihao Tang, Nils Wallenberg.\n\nThe original code has been modified to work without QGIS to facilitate Python workflows.\n\nThe original code can be found at: [UMEP-processing](https://github.com/UMEP-dev/UMEP-processing).\n\nThis modified code is licensed under the GNU General Public License v3.0.\n\nSee the LICENSE file for details.\n\nPlease give all credit for UMEP code to the original authors and cite accordingly.\n\n\u00a9 Copyright 2018 - 2020, Fredrik Lindberg, Ting Sun, Sue Grimmond, Yihao Tang, Nils Wallenberg.\n\nLindberg F, Grimmond CSB, Gabey A, Huang B, Kent CW, Sun T, Theeuwes N, J\u00e4rvi L, Ward H, Capel- Timms I, Chang YY, Jonsson P, Krave N, Liu D, Meyer D, Olofson F, Tan JG, W\u00e4stberg D, Xue L, Zhang Z (2018) Urban Multi-scale Environmental Predictor (UMEP) - An integrated tool for city-based climate services. Environmental Modelling and Software.99, 70-87 https://doi.org/10.1016/j.envsoft.2017.09.020\n\n## Demo Data\n\nTwo seprated demo dataset are included\n\n### ATENS (vector data)\n\n#### Tree Canopies\n\nCopernicus\n\n#### Trees\n\nhttps://walkable.cityofathens.gr/home\n\n#### Buildings\n\nhttp://gis.cityofathens.gr/layers/athens_geonode_data:geonode:c40solarmap\n\n### Gothenburg (raster data)\n\nStandard dataset used in tutorials (https://umep-docs.readthedocs.io/en/latest/Tutorials.html)\n\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "urban multi-scale environmental predictor",
"version": "0.0.1b2",
"project_urls": {
"documentation": "https://github.com/UMEP-dev/umep-core",
"homepage": "https://github.com/UMEP-dev/umep-core",
"repository": "https://github.com/UMEP-dev/umep-core"
},
"split_keywords": [
"python3",
" geographical-information-system",
" spatial-data",
" spatial-data-analysis",
" urban-climate",
" urban-heat-island",
" urban-meteorology",
" urban-microclimate",
" urban-planning",
" urban-sustainability",
" urban-thermal-comfort",
" urban-thermal-environment",
" urban-thermal-mapping",
" urban-thermal-modelling",
" urban-thermal-simulation",
" urban-thermal-sustainability"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4ae9c114c4b0d0741232703aa55f3a2bb23bc99f7bb6687eb5fc71958e29c21b",
"md5": "0f1d9bab35195f01950202f1d9eb3098",
"sha256": "4bc9566922aee961e2bb5ce3d3adc929eb56fb0ddff180933334778338810d18"
},
"downloads": -1,
"filename": "umep-0.0.1b2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0f1d9bab35195f01950202f1d9eb3098",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.14,>=3.10",
"size": 1880608,
"upload_time": "2025-07-30T10:31:53",
"upload_time_iso_8601": "2025-07-30T10:31:53.667336Z",
"url": "https://files.pythonhosted.org/packages/4a/e9/c114c4b0d0741232703aa55f3a2bb23bc99f7bb6687eb5fc71958e29c21b/umep-0.0.1b2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ca9a76881d59519f88dd69df4a4eb961fb2a1ba1cc799eb6b826ebfca6246896",
"md5": "a4e4735f64bdcbc3710e8a81e019c619",
"sha256": "a9d416250c822e4835d00fd49f36acb949c3951072c7cfbc017d89ab34a5c849"
},
"downloads": -1,
"filename": "umep-0.0.1b2.tar.gz",
"has_sig": false,
"md5_digest": "a4e4735f64bdcbc3710e8a81e019c619",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.14,>=3.10",
"size": 1880688,
"upload_time": "2025-07-30T10:31:55",
"upload_time_iso_8601": "2025-07-30T10:31:55.116168Z",
"url": "https://files.pythonhosted.org/packages/ca/9a/76881d59519f88dd69df4a4eb961fb2a1ba1cc799eb6b826ebfca6246896/umep-0.0.1b2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-30 10:31:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "UMEP-dev",
"github_project": "umep-core",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "umep"
}
JSON
