Add support for Zarr upstream datasets + GLO-30 and GLO-90 from Earth Data Hub

CHANGELOG.rst

@@ -16,6 +16,11 @@
 - Download the original SRTM GL1 data from OpenTopography for the ``SRTM1_GEOID`` product.
 - Add the ``MAPZEN`` product for the global Mapzen terrain tiles mosaic and make
   it the default product.
+- Add the ``GLO-30`` and ``GLO-90`` products for the Copernicus DEM global 30m and 90m
+  DSM on the EGM2008 geoid. They are distributed by the Earth Data Hub as a cloud-hosted
+  Zarr store that is read in place, one chunk at a time, and cached as GeoTIFF tiles
+  like the other products, so the credentials in ``~/.netrc`` are used and GDAL 3.8 or
+  later is required.
 - Retire the ``SRTM1`` product name: requesting it raises an error pointing to the
   migration notes.
 - Accept ``str`` or ``Path`` for all path-valued arguments.

README.md

@@ -15,6 +15,10 @@ Elevation provides easy download, cache and access of the global datasets:
   hosted on OpenTopography, 30m heights on the WGS84 ellipsoid.
 - `SRTM3`: [SRTM global 90m v4.1](https://bigdata.cgiar.org/srtm-90m-digital-elevation-database/)
   produced by CGIAR-CSI.
+- `GLO-30`: [Copernicus DEM global 30m (2021)](https://doi.org/10.5270/ESA-c5d3d65)
+  produced by ESA and the European Union, 30m heights on the EGM2008 geoid.
+- `GLO-90`: [Copernicus DEM global 90m (2021)](https://doi.org/10.5270/ESA-c5d3d65)
+  the 90m companion of `GLO-30`.
 
 Note that any download policies and attribution requirements of the respective providers apply.
 
@@ -69,6 +73,26 @@ For the SRTM global 90m v4.1 DEM use:
 $ eio --product SRTM3 clip -o Rome-SRTM3-DEM.tif --bounds 12.35 41.8 12.65 42
 ```
 
+For the Copernicus DEM global 30m or 90m DEMs use:
+
+```console
+$ eio --product GLO-30 clip -o Rome-GLO-30-DEM.tif --bounds 12.35 41.8 12.65 42
+$ eio --product GLO-90 clip -o Rome-GLO-90-DEM.tif --bounds 12.35 41.8 12.65 42
+```
+
+The `GLO-30` and `GLO-90` products are distributed by the Earth Data Hub as a
+single cloud-hosted Zarr store that is read in place and cached one chunk at a
+time instead of downloading whole tiles, and the credentials of the account
+stored in `~/.netrc` are used to access it:
+
+```console
+machine data.earthdatahub.destine.eu
+    login <your-username>
+    password <your-password>
+```
+
+Reading the store needs GDAL 3.8 or later.
+
 The `--bounds` option accepts latitude and longitude coordinates
 (more precisely in geodetic coordinates in the WGS84 reference system EPSG:4326 for those who care)
 given as `left bottom right top` similarly to the `rio` command form `rasterio`.
@@ -91,6 +115,8 @@ The first time an area is accessed Elevation downloads the data tiles from
 the AWS S3, CGIAR-CSI or OpenTopography servers and
 caches them in GeoTIFF compressed formats,
 subsequent accesses to the same and nearby areas are much faster.
+The `GLO-30` and `GLO-90` products are the exception: they are read in place
+from the Earth Data Hub and cached one Zarr chunk at a time.
 
 The `clip` sub-command doesn't allow automatic download of a large amount of DEM tiles,
 please refer to the upstream providers' websites to learn the preferred procedures for bulk download.
@@ -121,8 +147,8 @@ $ eio --help
 ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
 │ --version                                                 Show the version and exit.             │
 │                                                           [env var: EIO_VERSION]                 │
-│ --product          [MAPZEN|SRTM1_GEOID|SRTM1_ELLIP|SRTM3  DEM product choice.                    │
-│                    ]                                      [env var: EIO_PRODUCT]                 │
+│ --product          [MAPZEN|GLO-30|GLO-90|SRTM1_GEOID|SRT  DEM product choice.                    │
+│                    M1_ELLIP|SRTM3]                        [env var: EIO_PRODUCT]                 │
 │                                                           [default: MAPZEN]                      │
 │ --cache_dir        <directory>                            Root of the DEM cache folder.          │
 │                                                           [env var: EIO_CACHE_DIR]               │

docs/index.md

@@ -1,7 +1,7 @@
 # elevation
 
 Download, cache and clip global terrain digital elevation models: Mapzen terrain
-tiles, SRTM 30m and 90m DEMs.
+tiles, SRTM 30m and 90m DEMs, Copernicus DEM 30m and 90m DSMs.
 
 If you have any feedback or you want to help out head over to our main repository:
 https://github.com/bopen/elevation

elevation/datasets/elevation.yaml

@@ -1,6 +1,6 @@
 id: elevation
 title: elevation datasets
-description: 'Download, cache and clip global terrain digital elevation models: Mapzen terrain tiles, SRTM 30m and 90m DEMs.'
+description: 'Download, cache and clip global terrain digital elevation models: Mapzen terrain tiles, SRTM 30m and 90m DEMs, Copernicus DEM 30m and 90m DSMs.'
 type: Catalog
 stac_version: 1.1.0
 links: