Add GlacierMappingAlps dataset

[dcodrut]

This PR adds a a Multi-modal Dataset for Glacier Mapping (Segmentation) in the European Alps.

The dataset consists of Sentinel-2 images from 2015 (mainly), 2016 and 2017, and binary segmentation masks for glaciers, based on an inventory built by glaciology experts (Paul et al. 2020).
Given that glacier ice is not always visible in the images, due to seasonal snow, shadow/cloud cover and, most importantly, debris cover, the dataset also includes additional features that can help in the segmentation task.

Here's a sample extracted with the plot function implemented in the dataset:

A preprint is available here that describes in detail how the dataset was constructed.
For a shorter description check also: https://huggingface.co/datasets/dcodrut/dl4gam_alps.

[nilsleh]

Thanks a lot for the contribution :) I hope this first round of review is able to resolve the import xarray error that is preventing the unit tests from running. Once they are working, will take another look for anything else!

[dcodrut]

@microsoft-github-policy-service agree

[dcodrut]

Thanks a lot for the contribution :) I hope this first round of review is able to resolve the import xarray error that is preventing the unit tests from running. Once they are working, will take another look for anything else!

I hope it will be somehow useful. Happy to contribute and learn new things on the way :)
Thanks for the comments and please let me know if there are additional things I should change.

[adamjstewart]

I'm completely fine with adding xarray and netcdf4 as optional dependencies. We've been talking about adding xarray support for a long time. We're still not sure if it will be directly through xarray or something like rioxarray, but that doesn't matter for this PR.

[adamjstewart]

Can you resolve the merge conflicts so the tests run?

[adamjstewart]

Can you resolve the merge conflicts? These requirements files unfortunately get updated a lot, causing merge issues.

[adamjstewart]

Code looks fantastic, just a few minor formatting comments. Thanks for taking the time to contribute your dataset to TorchGeo, let's hope it makes it easier for people to actually use and do cool science with!

[adamjstewart]

These also need to be added to pyproject.toml. We'll need to find minimum versions that allow the tests to pass. I can help with this if you want.

[dcodrut]

I found the minimum versions, manually. Do you use any tool for this?

[adamjstewart]

Nah, I do it manually too, you can use binary search to speed it up though.

[adamjstewart]

Should we rename the dataset to DL4GAM or DL4GAMAlps? Or is DL4GAM the project/model and GlacierMappingAlps is the name of the dataset? It's up to you, it's your dataset.

[dcodrut]

Was not sure when I named it. Thanks for the suggestion, I think the second (DL4GAMAlps) makes more sense, and it's also consistent with the HF dataset.