# GrIML - Investigating Greenland's ice-marginal lakes under a changing climate
[](https://badge.fury.io/py/griml) [](https://zenodo.org/badge/latestdoi/444752900) [](https://griml.readthedocs.io/en/latest/?badge=latest) [](https://actions-badge.atrox.dev/PennyHow/GrIML/goto?ref=main)
The **GrIML** processing package for classifying water bodies from satellite imagery using a multi-sensor, multi-method remote sensing approach. This workflow is used for the production of the [Greenland ice-marginal lake inventory series](https://doi.org/10.22008/FK2/MBKW9N), as part of the [ESA GrIML project](https://eo4society.esa.int/projects/griml/). This repository also holds all project-related materials.
## Installation
The GrIML Python package can be installed using pip:
```
$ pip install griml
```
Or cloned from the Github repository:
```
$ git clone git@github.com:GEUS-Glaciology-and-Climate/GrIML.git
$ cd GrIML
$ pip install .
```
Full documentation and tutorials are available at GrIML's [readthedocs](https://griml.readthedocs.io)
## Workflow outline
<img src="https://github.com/GEUS-Glaciology-and-Climate/GrIML/blob/main/docs/figures/griml_workflow_with_gee.png?raw=true" alt="The GrIML workflow." width="1500" align="aligncenter" />
**GrIML** proposes to examine ice marginal lake changes across Greenland using a multi-sensor and multi-method remote sensing approach to better address their influence on sea level contribution forecasting.
Ice-marginal lakes are detected using a remote sensing approach, based on offline workflows developed within the [ESA Glaciers CCI](https://catalogue.ceda.ac.uk/uuid/7ea7540135f441369716ef867d217519") (Option 6, An Inventory of Ice-Marginal Lakes in Greenland) ([How et al., 2021](https://www.nature.com/articles/s41598-021-83509-1)). Initial classifications are performed using Google Earth Engine, with the scripts available [here](https://github.com/GEUS-Glaciology-and-Climate/GrIML/tree/main/gee_scripts). Lake extents are defined through a multi-sensor approach using:
- Multi-spectral indices classification from Sentinel-2 optical imagery
- Backscatter classification from Sentinel-1 SAR (synthetic aperture radar) imagery
- Sink detection from ArcticDEM digital elevation models
Post-processing of these classifications is performed using the **GrIML** Python package, including raster-to-vector conversion, filtering, merging, metadata population, and statistical analysis.
## Terms of use
If the workflow or data are presented or used to support results of any kind, please include an acknowledgement and references to the applicable publications:
*How, P. et al. (2025) "Greenland Ice-Marginal Lake Inventory annual time-series Edition 1". GEUS Dataverse. [https://doi.org/10.22008/FK2/MBKW9N](https://doi.org/10.22008/FK2/MBKW9N)*
*How, P. (2024) PennyHow/GrIML v0.1.0, Zenodo, [https://doi.org/10.5281/zenodo.11395471](https://doi.org/10.5281/zenodo.11395471)*
*How, P. et al. (2021) "Greenland-wide inventory of ice marginal lakes using a multi-method approach". Sci. Rep. 11, 4481. [https://doi.org/10.1038/s41598-021-83509-1](https://doi.org/10.1038/s41598-021-83509-1)*
## Project links
- [The Greenland ice-marginal lake inventory series](https://doi.org/10.22008/FK2/MBKW9N), available through the [GEUS Dataverse](https://dataverse.geus.dk/)
- ESA [project outline](https://eo4society.esa.int/projects/griml/) and [fellow information](https://eo4society.esa.int/lpf/penelope-how/)
- [GrIML project description](https://pennyhow.github.io/blog/investigating-griml/)
- Information about the [ESA Living Planet Fellowship](https://eo4society.esa.int/communities/scientists/living-planet-fellowship/)
- 2017 ice marginal lake inventory [Scientific Reports paper](https://www.nature.com/articles/s41598-021-83509-1) and [dataset](https://catalogue.ceda.ac.uk/uuid/7ea7540135f441369716ef867d217519)
Raw data
{
"_id": null,
"home_page": null,
"name": "griml",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Penelope How <pho@geus.dk>",
"keywords": "glaciology, remote sensing, cryosphere, ice marginal lake, ESA",
"author": null,
"author_email": "Penelope How <pho@geus.dk>",
"download_url": "https://files.pythonhosted.org/packages/aa/c9/ba60364e2157e63be6578914a3dd64b9edc5dbaf5dbf8aab1f40e1b7122c/griml-1.0.0.tar.gz",
"platform": null,
"description": "# GrIML - Investigating Greenland's ice-marginal lakes under a changing climate\n\n[](https://badge.fury.io/py/griml) [](https://zenodo.org/badge/latestdoi/444752900) [](https://griml.readthedocs.io/en/latest/?badge=latest) [](https://actions-badge.atrox.dev/PennyHow/GrIML/goto?ref=main)\n\nThe **GrIML** processing package for classifying water bodies from satellite imagery using a multi-sensor, multi-method remote sensing approach. This workflow is used for the production of the [Greenland ice-marginal lake inventory series](https://doi.org/10.22008/FK2/MBKW9N), as part of the [ESA GrIML project](https://eo4society.esa.int/projects/griml/). This repository also holds all project-related materials.\n\n\n## Installation\n\nThe GrIML Python package can be installed using pip: \n\n```\n$ pip install griml\n```\n\nOr cloned from the Github repository: \n\n```\n$ git clone git@github.com:GEUS-Glaciology-and-Climate/GrIML.git\n$ cd GrIML\n$ pip install .\n```\n\nFull documentation and tutorials are available at GrIML's [readthedocs](https://griml.readthedocs.io)\n\n\n## Workflow outline\n\n<img src=\"https://github.com/GEUS-Glaciology-and-Climate/GrIML/blob/main/docs/figures/griml_workflow_with_gee.png?raw=true\" alt=\"The GrIML workflow.\" width=\"1500\" align=\"aligncenter\" />\n\n**GrIML** proposes to examine ice marginal lake changes across Greenland using a multi-sensor and multi-method remote sensing approach to better address their influence on sea level contribution forecasting.\n\nIce-marginal lakes are detected using a remote sensing approach, based on offline workflows developed within the [ESA Glaciers CCI](https://catalogue.ceda.ac.uk/uuid/7ea7540135f441369716ef867d217519\") (Option 6, An Inventory of Ice-Marginal Lakes in Greenland) ([How et al., 2021](https://www.nature.com/articles/s41598-021-83509-1)). Initial classifications are performed using Google Earth Engine, with the scripts available [here](https://github.com/GEUS-Glaciology-and-Climate/GrIML/tree/main/gee_scripts). Lake extents are defined through a multi-sensor approach using:\n\n- Multi-spectral indices classification from Sentinel-2 optical imagery\n- Backscatter classification from Sentinel-1 SAR (synthetic aperture radar) imagery\n- Sink detection from ArcticDEM digital elevation models \n\nPost-processing of these classifications is performed using the **GrIML** Python package, including raster-to-vector conversion, filtering, merging, metadata population, and statistical analysis.\n\n\n## Terms of use\n\nIf the workflow or data are presented or used to support results of any kind, please include an acknowledgement and references to the applicable publications:\n\n*How, P. et al. (2025) \"Greenland Ice-Marginal Lake Inventory annual time-series Edition 1\". GEUS Dataverse. [https://doi.org/10.22008/FK2/MBKW9N](https://doi.org/10.22008/FK2/MBKW9N)*\n\n*How, P. (2024) PennyHow/GrIML v0.1.0, Zenodo, [https://doi.org/10.5281/zenodo.11395471](https://doi.org/10.5281/zenodo.11395471)*\n\n*How, P. et al. (2021) \"Greenland-wide inventory of ice marginal lakes using a multi-method approach\". Sci. Rep. 11, 4481. [https://doi.org/10.1038/s41598-021-83509-1](https://doi.org/10.1038/s41598-021-83509-1)*\n\n\n## Project links\n\n- [The Greenland ice-marginal lake inventory series](https://doi.org/10.22008/FK2/MBKW9N), available through the [GEUS Dataverse](https://dataverse.geus.dk/)\n\n- ESA [project outline](https://eo4society.esa.int/projects/griml/) and [fellow information](https://eo4society.esa.int/lpf/penelope-how/)\n\n- [GrIML project description](https://pennyhow.github.io/blog/investigating-griml/)\n\n- Information about the [ESA Living Planet Fellowship](https://eo4society.esa.int/communities/scientists/living-planet-fellowship/)\n\n- 2017 ice marginal lake inventory [Scientific Reports paper](https://www.nature.com/articles/s41598-021-83509-1) and [dataset](https://catalogue.ceda.ac.uk/uuid/7ea7540135f441369716ef867d217519)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A workflow for classifying ice-marginal lakes from satellite imagery and compiling lake inventories",
"version": "1.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/GEUS-Glaciology-and-Climate/GrIML/issues",
"Homepage": "https://github.com/GEUS-Glaciology-and-Climate/GrIML"
},
"split_keywords": [
"glaciology",
" remote sensing",
" cryosphere",
" ice marginal lake",
" esa"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ecfc704f3cd8e9c4b08c006a4b7515a4895acb34ccf3319e8eea655d69d5afc9",
"md5": "440b1879dc5dcdfa4ad7f89ff029db48",
"sha256": "30c8d9e3824d8da09040782c94d9027465b0420c0bbb3db067a0e797d17c3994"
},
"downloads": -1,
"filename": "griml-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "440b1879dc5dcdfa4ad7f89ff029db48",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 44501,
"upload_time": "2025-01-22T13:22:53",
"upload_time_iso_8601": "2025-01-22T13:22:53.316425Z",
"url": "https://files.pythonhosted.org/packages/ec/fc/704f3cd8e9c4b08c006a4b7515a4895acb34ccf3319e8eea655d69d5afc9/griml-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "aac9ba60364e2157e63be6578914a3dd64b9edc5dbaf5dbf8aab1f40e1b7122c",
"md5": "8d4ac45a6a96182ebc900cd199466ef2",
"sha256": "463d8a300139a47ff9c79713545893d6d077ec577a765a152f6246279dcc8176"
},
"downloads": -1,
"filename": "griml-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "8d4ac45a6a96182ebc900cd199466ef2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 28014,
"upload_time": "2025-01-22T13:22:54",
"upload_time_iso_8601": "2025-01-22T13:22:54.933919Z",
"url": "https://files.pythonhosted.org/packages/aa/c9/ba60364e2157e63be6578914a3dd64b9edc5dbaf5dbf8aab1f40e1b7122c/griml-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-22 13:22:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GEUS-Glaciology-and-Climate",
"github_project": "GrIML",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "griml"
}
JSON
