# Investigating Greenland's ice marginal lakes under a changing climate (GrIML)
[![PyPI version](https://badge.fury.io/py/griml.svg)](https://badge.fury.io/py/griml) [![DOI](https://zenodo.org/badge/444752900.svg)](https://zenodo.org/badge/latestdoi/444752900) [![Documentation Status](https://readthedocs.org/projects/griml/badge/?version=latest)](https://griml.readthedocs.io/en/latest/?badge=latest) [![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2FPennyHow%2FGrIML%2Fbadge%3Fref%3Dmain&style=flat)](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 part of the [ESA GrIML project](https://eo4society.esa.int/projects/griml/), and this repository also holds all project-related materials.
## Installation
The GrIML post-processing Python package can be installed using pip:
```
$ pip install griml
```
Or cloned from the Github repository:
```
$ git clone git@github.com:PennyHow/GrIML.git
$ cd GrIML
$ pip install .
```
## Workflow outline
<img src="https://github.com/PennyHow/GrIML/blob/main/other/reporting/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 on Google Earth Engine with the scripts available [here](https://github.com/PennyHow/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 post-processing Python package, including raster-to-vector conversion, filtering, merging, metadata population, and statistical analysis.
## Project links
- ESA [project outline](https://eo4society.esa.int/projects/griml/) and [fellow information](https://eo4society.esa.int/lpf/penelope-how/)
- Information about the [ESA Living Planet Fellowship](https://eo4society.esa.int/communities/scientists/living-planet-fellowship/)
- [GrIML project description](https://pennyhow.github.io/blog/investigating-griml/)
- 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": "https://github.com/PennyHow/GrIML",
"name": "griml",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "glaciology ice lake ESA",
"author": "Penelope How",
"author_email": "pho@geus.dk",
"download_url": "https://files.pythonhosted.org/packages/e6/48/9c3f3faf1388953ce4ff3709c19c53b7ad8239b9212e66da09e08d660f74/griml-0.1.0.tar.gz",
"platform": null,
"description": "# Investigating Greenland's ice marginal lakes under a changing climate (GrIML)\n\n[![PyPI version](https://badge.fury.io/py/griml.svg)](https://badge.fury.io/py/griml) [![DOI](https://zenodo.org/badge/444752900.svg)](https://zenodo.org/badge/latestdoi/444752900) [![Documentation Status](https://readthedocs.org/projects/griml/badge/?version=latest)](https://griml.readthedocs.io/en/latest/?badge=latest) [![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2FPennyHow%2FGrIML%2Fbadge%3Fref%3Dmain&style=flat)](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 part of the [ESA GrIML project](https://eo4society.esa.int/projects/griml/), and this repository also holds all project-related materials.\n\n## Installation\n\nThe GrIML post-processing Python package can be installed using pip: \n\n```\n$ pip install griml\n```\nOr cloned from the Github repository: \n\n```\n$ git clone git@github.com:PennyHow/GrIML.git\n$ cd GrIML\n$ pip install .\n```\n\n## Workflow outline\n\n<img src=\"https://github.com/PennyHow/GrIML/blob/main/other/reporting/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 on Google Earth Engine with the scripts available [here](https://github.com/PennyHow/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 post-processing Python package, including raster-to-vector conversion, filtering, merging, metadata population, and statistical analysis.\n\n## Project links\n\n- ESA [project outline](https://eo4society.esa.int/projects/griml/) and [fellow information](https://eo4society.esa.int/lpf/penelope-how/)\n\n- Information about the [ESA Living Planet Fellowship](https://eo4society.esa.int/communities/scientists/living-planet-fellowship/)\n\n- [GrIML project description](https://pennyhow.github.io/blog/investigating-griml/)\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": null,
"summary": "A workflow for classifying lakes from satellite imagery and compiling lake inventories",
"version": "0.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/PennyHow/GrIML/issues",
"Homepage": "https://github.com/PennyHow/GrIML"
},
"split_keywords": [
"glaciology",
"ice",
"lake",
"esa"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f1a23089e0826f153e724f49cd5e20b53250b439e05ac499270bf13eb120842a",
"md5": "0ea4c3cc12186fcfdfe4c0de32994780",
"sha256": "640b1ddb6d6aec6d9b0aa38655bb991226ce69beef470ca31e6cea5c25210830"
},
"downloads": -1,
"filename": "griml-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0ea4c3cc12186fcfdfe4c0de32994780",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 45331930,
"upload_time": "2024-05-30T12:28:06",
"upload_time_iso_8601": "2024-05-30T12:28:06.289843Z",
"url": "https://files.pythonhosted.org/packages/f1/a2/3089e0826f153e724f49cd5e20b53250b439e05ac499270bf13eb120842a/griml-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e6489c3f3faf1388953ce4ff3709c19c53b7ad8239b9212e66da09e08d660f74",
"md5": "fd2d910ef6ef9ee187d1a961bba0aab9",
"sha256": "bcf1f25ac9604215ca01f7d238f794bb13c6e4b2cd65d2e65153beb157e115b4"
},
"downloads": -1,
"filename": "griml-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "fd2d910ef6ef9ee187d1a961bba0aab9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 45246772,
"upload_time": "2024-05-30T12:28:10",
"upload_time_iso_8601": "2024-05-30T12:28:10.278400Z",
"url": "https://files.pythonhosted.org/packages/e6/48/9c3f3faf1388953ce4ff3709c19c53b7ad8239b9212e66da09e08d660f74/griml-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-30 12:28:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PennyHow",
"github_project": "GrIML",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "griml"
}