easysnowdata 0.2.0__tar.gz → 0.3.2__tar.gz

{easysnowdata-0.2.0 → easysnowdata-0.3.2}/CHANGELOG.md

@@ -6,6 +6,70 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 <!-- insertion marker -->
+## [v0.3.1](https://github.com/egagli/easysnowdata/releases/tag/v0.3.1) - 2026-09-22
+
+<small>[Compare with v0.2.0](https://github.com/egagli/easysnowdata/compare/v0.2.0...v0.3.1)</small>
+
+### Fixed
+
+- fix(planetscope): make a real order work end to end; gallery renders a real scene ([bd25c45](https://github.com/egagli/easysnowdata/commit/bd25c45c4212db5b1a5e212dec2fe295a9f1f5d6) by egagli).
+- fix(archive): open a scheme-less store path as a local store ([d71b0ee](https://github.com/egagli/easysnowdata/commit/d71b0ee753cef56ec9fdc0dc248b85fda202b5b5) by Eric Gagliano).
+- fix(sar): never fuse Sentinel-1 geometries — one raster per relative orbit ([c9fbe53](https://github.com/egagli/easysnowdata/commit/c9fbe53433a9ed8a36edadca1f72cafe67b387d8) by egagli).
+- fix(hls): a failed band read raises instead of filling the Dataset with nodata ([101d97f](https://github.com/egagli/easysnowdata/commit/101d97f5aa482ed74c4185486dbc8a3710c4fb26) by egagli).
+- fix(auth): log in at URS with the netrc for GDAL reads whenever a password exists ([1b7a1a1](https://github.com/egagli/easysnowdata/commit/1b7a1a13a66f3e71288967e41dcc61723dac5922) by egagli).
+- fix(sar): drop the nominal Sentinel-1 heading and the constant 39° incidence angle ([736499e](https://github.com/egagli/easysnowdata/commit/736499e0fcfdef3c1f4bfdc9ea33c5417198806a) by egagli).
+- fix(snow): Terra-only MODIS mosaics from Planetary Computer; real NSIDC-0768 file names ([8bbbdbd](https://github.com/egagli/easysnowdata/commit/8bbbdbdbe6d6c11411c867b07f5d578a672233ec) by egagli).
+- fix(sar): incidence angle from each track's geometry, with the right sign; OPERA reads work ([d12dc9f](https://github.com/egagli/easysnowdata/commit/d12dc9f37684c9dfb73287c08e0c2472f11254f3) by egagli).
+- fix(health): probe Planet through the SDK, send a User-Agent on first-byte probes ([e5aeb82](https://github.com/egagli/easysnowdata/commit/e5aeb82fc28802f3539aaea69c93e3d185b32553) by egagli).
+- fix(stations): finish the transfer — format the clients, relabel the probes, refresh the archive ([fb1bf3e](https://github.com/egagli/easysnowdata/commit/fb1bf3e191e27ee7453e23830a99bd6c85731016) by egagli).
+- fix(deprecation): the shims promised removal in the release they shipped in ([24e93b5](https://github.com/egagli/easysnowdata/commit/24e93b549e928cb6cfabd103b8ae40f9d1581b07) by egagli).
+
+## [v0.2.0](https://github.com/egagli/easysnowdata/releases/tag/v0.2.0) - 2026-09-17
+
+<small>[Compare with v0.0.26](https://github.com/egagli/easysnowdata/compare/v0.0.26...v0.2.0)</small>
+
+### Fixed
+
+- fix(live): three real bugs behind the failing live tests, one marker for the fourth ([0cbfafb](https://github.com/egagli/easysnowdata/commit/0cbfafb7821980be9ed7101e1dae5f7d839f8387) by egagli).
+- fix(providers): spell a local zip as /vsizip/ so Windows can open it ([599a296](https://github.com/egagli/easysnowdata/commit/599a296e0d8f6f95bdfa093f0cc8e642233658f3) by egagli).
+- fix(ci): generate the autosummary stubs on a first build, and stop writing COGs in fixtures ([7c3952c](https://github.com/egagli/easysnowdata/commit/7c3952c02f69a88dd978470d54306cd6f2671b95) by egagli).
+- fix(docs): drop the minigallery directive, and keep doctrees out of the site ([e051058](https://github.com/egagli/easysnowdata/commit/e051058dc47f1edf474c3a343c5f30d243dc0173) by egagli).
+- fix(docs): document a re-exported object once, not per module ([10a9b94](https://github.com/egagli/easysnowdata/commit/10a9b94b75ce151c190725c26f2e2de080c35c1a) by egagli).
+- fix(yukon): snowfall is its own type, not precipitation in centimetres ([e89ed0e](https://github.com/egagli/easysnowdata/commit/e89ed0ed3b376b216fd41ab9505f2be0242ae706) by egagli).
+- fix(stations): never rescale a depth of snowfall into a depth of water ([37e8aa8](https://github.com/egagli/easysnowdata/commit/37e8aa84c363935677837cf79a83be51ff2a931a) by egagli).
+- fix(clients): conform get_metadata for one station, emit hPa from Yukon ([defc053](https://github.com/egagli/easysnowdata/commit/defc05342fb1630206cc226aeedb1967b9071a8b) by egagli).
+- fix(awdb): serve TAVG, and prefer it over TOBS for the `temp` type ([87c8ea2](https://github.com/egagli/easysnowdata/commit/87c8ea2d23a9b883cf1997a2ac7903b4d754413f) by egagli).
+- fix(stations): three contract gaps the live tier found ([00560f6](https://github.com/egagli/easysnowdata/commit/00560f6106cf4f6d89722174029a4c379ddb1f1e) by egagli).
+- fix(snow): stream the NSIDC download with iter_content ([ad1473e](https://github.com/egagli/easysnowdata/commit/ad1473e34d45491390e74075d61bc036cf89a670) by Claude).
+- fix(earthaccess): do not treat a half-initialised login as logged in; retry once ([fa5f309](https://github.com/egagli/easysnowdata/commit/fa5f3094dc4c3866a02a14fcbadd4d47e1a6bda1) by egagli).
+- fix(modis): fail fast when GDAL has no HDF4 driver (MOD10A1F) ([f506c13](https://github.com/egagli/easysnowdata/commit/f506c1341943ec1d0bb059d8fae89028baf2adc7) by egagli).
+- fix(yukon): raise on unknown variables and unsupported intervals ([513bc0c](https://github.com/egagli/easysnowdata/commit/513bc0ca93498e16512e52199b1246726211b1e2) by egagli).
+- fix(nve): datetime on hourly records, no silent fallbacks, correct stale docstrings ([c7d499c](https://github.com/egagli/easysnowdata/commit/c7d499c3a4b2d30337e03311b0fe002e7b036551) by egagli).
+- fix(awdb): convert all variables to metric, add datetime to hourly records, validate inputs ([bdcda3c](https://github.com/egagli/easysnowdata/commit/bdcda3c257a315b1839366f533af9304a4e2ec4f) by egagli).
+- fix(cdec): preserve hourly timestamps, clean SWE priority logic, validate inputs ([8a75dbb](https://github.com/egagli/easysnowdata/commit/8a75dbb50c089a50434103000202de17475ef25a) by egagli).
+- fix(databc): wire hourly through get_data, scope negative-value filter, validate interval ([01a1a16](https://github.com/egagli/easysnowdata/commit/01a1a16e10c4f14d3911b43d6b03d5e753d2044f) by egagli).
+- fix: correct Nepal station coordinates via detect-and-override, not exclusion ([e6a3e0b](https://github.com/egagli/easysnowdata/commit/e6a3e0bd10c88bfcba6ab3542004d2e165640d56) by egagli).
+- fix: correct NVE parameter IDs, response parsing, flags — verified live ([fe202a9](https://github.com/egagli/easysnowdata/commit/fe202a97b6065dd96fd7b43ed8a64035101112e6) by egagli).
+- fix: NVE fetch self-diagnoses when /Series matches nothing ([71220bf](https://github.com/egagli/easysnowdata/commit/71220bfcd8a9a0a0ec03f58da9279ac0de84035c) by egagli).
+- fix: NVE Observations 404s — request only series that exist, chunked ([ff0f318](https://github.com/egagli/easysnowdata/commit/ff0f318d8ed3742b77947764392f853c65f4b8f3) by egagli).
+- fix: NVE Observations uses ReferenceTime not StartDate/EndDate ([c4f8aee](https://github.com/egagli/easysnowdata/commit/c4f8aeee52650259aca0f41162cf6433b652487c) by egagli).
+- fix: use correct NVE Observations query param name ([c6b44f5](https://github.com/egagli/easysnowdata/commit/c6b44f5178b8c0de79063f4c69aef30a0a9a386d) by egagli).
+- fix: NVE Observations 400 (date format), 429 (rate limit), begin_date ([18d0a51](https://github.com/egagli/easysnowdata/commit/18d0a515769703c651e4f0a2ca8ae29fe465f856) by egagli).
+- fix: NVE parameters missing when filtering by ParameterId, CI missing API key ([5deee41](https://github.com/egagli/easysnowdata/commit/5deee415a5793ff175f368ca900b3729af3f338d) by egagli).
+- fix: NVE API key auth, Pages permissions, detached HEAD push ([fbbc4d7](https://github.com/egagli/easysnowdata/commit/fbbc4d7a6826ef23c34d8a81357ca1b2c7daeb5b) by egagli).
+- fix awdb metadata adaptive batching ([367639a](https://github.com/egagli/easysnowdata/commit/367639a61ecadd583ff2ed28c41c4b082245820f) by egagli).
+- fix: restore variables_daily for CDEC/DataBC; update README field docs ([8a256ff](https://github.com/egagli/easysnowdata/commit/8a256ff8431be7bde33d346024762c06d55bec4a) by egagli).
+
+## [v0.0.26](https://github.com/egagli/easysnowdata/releases/tag/v0.0.26) - 2026-09-15
+
+<small>[Compare with v0.0.25](https://github.com/egagli/easysnowdata/compare/v0.0.25...v0.0.26)</small>
+
+### Fixed
+
+- fix(hydro): read Köppen-Geiger file 61012822 via ndownloader.figshare.com ([e78aece](https://github.com/egagli/easysnowdata/commit/e78aeceb347fb56e625f347fe9f848c8c5739521) by egagli).
+- fix(earthaccess): explicit login, cloud-hosted MOD10A1F, cache dir, UCLA stats index ([a8c2d3e](https://github.com/egagli/easysnowdata/commit/a8c2d3e73a5929a627eac826b750f80f8305223f) by egagli).
+- fix(hydro): fetch GRDC WMO basins with GET into a cache; GET-first health probe ([69ab0e0](https://github.com/egagli/easysnowdata/commit/69ab0e0a49275fdcc7737f53a2ca39f0569af6e6) by egagli).
+
 ## [v0.0.25](https://github.com/egagli/easysnowdata/releases/tag/v0.0.25) - 2026-08-25
 
 <small>[Compare with v0.0.24](https://github.com/egagli/easysnowdata/compare/v0.0.24...v0.0.25)</small>

{easysnowdata-0.2.0 → easysnowdata-0.3.2}/CITATION.cff

@@ -38,5 +38,5 @@ keywords:
   - snow classification
   - easysnowdata
 license: MIT
-version: v0.2.0
-date-released: '2026-09-17'
+version: v0.3.2
+date-released: '2026-09-23'

{easysnowdata-0.2.0 → easysnowdata-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: easysnowdata
-Version: 0.2.0
+Version: 0.3.2
 Summary: A Python package to easily retrieve data relevant to snow science
 Project-URL: Homepage, https://github.com/egagli/easysnowdata
 Project-URL: Documentation, https://egagli.github.io/easysnowdata
@@ -20,6 +20,7 @@ Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
 Classifier: Topic :: Scientific/Engineering :: GIS
 Requires-Python: >=3.12
 Requires-Dist: beautifulsoup4
+Requires-Dist: contextily
 Requires-Dist: dask
 Requires-Dist: earthaccess>=0.17
 Requires-Dist: earthengine-api
@@ -30,6 +31,7 @@ Requires-Dist: h5netcdf
 Requires-Dist: h5py
 Requires-Dist: lxml
 Requires-Dist: matplotlib
+Requires-Dist: matplotlib-scalebar
 Requires-Dist: numpy
 Requires-Dist: odc-geo>=0.5
 Requires-Dist: odc-stac>=0.5
@@ -47,7 +49,6 @@ Requires-Dist: rasterio>=1.5
 Requires-Dist: requests
 Requires-Dist: rioxarray>=0.22
 Requires-Dist: s3fs
-Requires-Dist: scikit-image
 Requires-Dist: shapely>=2
 Requires-Dist: tqdm
 Requires-Dist: xarray>=2026.2
@@ -90,59 +91,96 @@ and a recovery closes it; latency and DMR++ readiness are on the
 [status page](https://egagli.github.io/easysnowdata/status.html).
 
 <!-- DATA_STATUS_START -->
-_Last updated: 2026-09-17 21:39 UTC_  
+_Last updated: 2026-09-22 01:46 UTC_  
 _⚠️ = skipped (credentials not available in this run). Latency and virtualization probes are on the [status page](https://egagli.github.io/easysnowdata/status.html)._
 
-| Data Source | Latest (Sep 17) | Sep 14 | Sep 7 | Aug 31 |
+### Stations (`esd.stations`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
 | :---------- | :------: | :------: | :------: | :------: |
-| AWDB stations (NRCS REST API) | ✅ | — | — | — |
-| CDEC stations (JSON data servlet) | ✅ | — | — | — |
-| BC snow stations (DataBC WFS) | ✅ | — | — | — |
-| NVE stations (HydAPI) | ⚠️ | — | — | — |
-| Yukon stations (AquaCache API) | ✅ | — | — | — |
-| SNOTEL/CCSS station list (GitHub) | ✅ | ✅ | ✅ | ✅ |
-| Snow station archive tarball (global_snow_networks) | ✅ | — | — | — |
-| SNOTEL/CCSS station CSV (GitHub) | ✅ | ✅ | ✅ | ✅ |
-| ARCO-ERA5 (GCS anonymous) | ✅ | ✅ | ✅ | ✅ |
-| ERA5 (Google Earth Engine) | ✅ | ✅ | ✅ | ✅ |
-| Köppen-Geiger classification (figshare) | ✅ | ✅ | ✅ | ✅ |
-| HUC geometries (USGS WBD REST) | ✅ | — | — | — |
-| HUC geometries (GEE/USGS WBD) | ✅ | ✅ | ✅ | ✅ |
-| HydroATLAS basins (figshare) | ✅ | ✅ | ✅ | ✅ |
-| HydroBASINS (HydroSHEDS regional zip) | ✅ | — | — | — |
-| HydroBASINS (GEE/HydroATLAS) | ✅ | — | — | — |
-| GRDC major river basins (World Bank) | ✅ | ✅ | ✅ | ✅ |
-| GRDC WMO basins | <abbr title="ConnectionError: ('Connection aborted.', ConnectionResetError(104, 'Connection r">❌</abbr> | <abbr title="RuntimeError: Unreachable: HTTP 404">❌</abbr> | <abbr title="RuntimeError: Unreachable: HTTP 404">❌</abbr> | <abbr title="RuntimeError: Unreachable: HTTP 404">❌</abbr> |
-| MODIS snow cover MOD10A1F (NASA NSIDC) | ✅ | — | — | — |
-| MODIS snow cover MOD10A1 (Planetary Computer) | ✅ | — | — | — |
+| AWDB stations (NRCS REST API) | ✅ | ✅ | — | — |
+| CDEC stations (JSON data servlet) | ✅ | ✅ | — | — |
+| BC snow stations (DataBC WFS) | ✅ | ✅ | — | — |
+| NVE stations (HydAPI) | <abbr title="RuntimeError: Unreachable: HTTP 401">❌</abbr> | ⚠️ | — | — |
+| Yukon stations (AquaCache API) | ✅ | ✅ | — | — |
+| Snow station inventory (global_snow_networks) | ✅ | ✅ | ✅ | ✅ |
+| Snow station archive tarball (global_snow_networks) | ✅ | ✅ | — | — |
+| Snow station CSV (global_snow_networks) | ✅ | ✅ | ✅ | ✅ |
+
+### Snow (`esd.snow`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| MODIS snow cover MOD10A1F (NASA NSIDC) | ✅ | ✅ | — | — |
+| MODIS snow cover MOD10A1 (Planetary Computer) | ✅ | ✅ | — | — |
 | Mountain snow mask (Zenodo) | ✅ | ✅ | ✅ | ✅ |
-| SNODAS (NSIDC G02158) | ✅ | — | — | — |
+| SNODAS (NSIDC G02158) | ✅ | ✅ | — | — |
 | SNODAS (GEE/Climate Engine) | ✅ | ✅ | ✅ | ✅ |
-| Sturm & Liston snow classification (NSIDC-0768) | ✅ | — | — | — |
+| Sturm & Liston snow classification (NSIDC-0768) | ✅ | ✅ | — | — |
 | Sturm & Liston snow classification (Azure) | ✅ | ✅ | ✅ | ✅ |
-| UCLA Snow Reanalysis (NASA NSIDC) | ✅ | ⚠️ | ⚠️ | ⚠️ |
-| HMA Snow Reanalysis (NASA NSIDC) | ✅ | — | — | — |
-| VIIRS snow cover VNP10A1F (NASA NSIDC) | ✅ | — | — | — |
+| UCLA Snow Reanalysis (NASA NSIDC) | ✅ | ✅ | ⚠️ | ⚠️ |
+| HMA Snow Reanalysis (NASA NSIDC) | ✅ | ✅ | — | — |
+| VIIRS snow cover VNP10A1F (NASA NSIDC) | ✅ | ✅ | — | — |
+
+### SAR (`esd.sar`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| Sentinel-1 RTC (Planetary Computer) | ✅ | ✅ | — | — |
+| Sentinel-1 RTC OPERA (CMR-STAC ASF) | ✅ | ✅ | — | — |
+| Sentinel-1 RTC OPERA (Earth Engine) | ✅ | ✅ | — | — |
+| Sentinel-1 static layers (CMR-STAC ASF) | ✅ | ✅ | — | — |
+| Copernicus DEM for the incidence angle (Planetary Computer) | ✅ | ✅ | — | — |
+| Sentinel-1 GRD angle band (Earth Engine) | ✅ | ✅ | — | — |
+
+### Optical imagery (`esd.optical`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| HLS L30 (CMR-STAC LPCLOUD) | ✅ | ✅ | — | — |
+| HLS S30 (Planetary Computer) | ✅ | ✅ | — | — |
+| PlanetScope (Planet Data API) | <abbr title="DeprecationWarning: Auth.value has been deprecated.">❌</abbr> | ⚠️ | — | — |
+| Sentinel-2 L2A (Planetary Computer) | ✅ | ✅ | — | — |
+| Sentinel-2 L2A (Earth Search) | ✅ | ✅ | — | — |
+
+### Terrain (`esd.terrain`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| CHILI (GEE/CSP ERGo) | ✅ | ✅ | ✅ | ✅ |
+| Copernicus DEM (Planetary Computer) | ✅ | ✅ | ✅ | ✅ |
+| Copernicus DEM (Earth Search) | ✅ | ✅ | — | — |
+
+### Land cover (`esd.land`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
 | Forest cover fraction (Zenodo) | ✅ | ✅ | ✅ | ✅ |
-| Forest cover fraction (GEE/CGLS-LC100) | ✅ | — | — | — |
+| Forest cover fraction (GEE/CGLS-LC100) | ✅ | ✅ | — | — |
 | ESA WorldCover (Planetary Computer) | ✅ | ✅ | ✅ | ✅ |
-| ESA WorldCover (AWS bucket) | ✅ | — | — | — |
-| Annual NLCD (GEE community asset) | ✅ | — | — | — |
+| ESA WorldCover (AWS bucket) | ✅ | ✅ | — | — |
+| Annual NLCD (GEE community asset) | ✅ | ✅ | — | — |
 | NLCD (GEE/USGS) | ✅ | ✅ | ✅ | ✅ |
-| HLS L30 (CMR-STAC LPCLOUD) | ✅ | — | — | — |
-| HLS S30 (Planetary Computer) | ✅ | — | — | — |
-| PlanetScope (Planet Data API) | ⚠️ | — | — | — |
-| Sentinel-2 L2A (Planetary Computer) | ✅ | — | — | — |
-| Sentinel-2 L2A (Earth Search) | ✅ | — | — | — |
-| Sentinel-1 RTC (Planetary Computer) | ✅ | — | — | — |
-| Sentinel-1 RTC OPERA (CMR-STAC ASF) | ✅ | — | — | — |
-| Sentinel-1 RTC OPERA (Earth Engine) | ✅ | — | — | — |
-| Sentinel-1 static layers (CMR-STAC ASF) | ✅ | — | — | — |
-| Copernicus DEM for the incidence angle (Planetary Computer) | ✅ | — | — | — |
-| Sentinel-1 GRD angle band (Earth Engine) | ✅ | — | — | — |
-| CHILI (GEE/CSP ERGo) | ✅ | ✅ | ✅ | ✅ |
-| Copernicus DEM (Planetary Computer) | ✅ | ✅ | ✅ | ✅ |
-| Copernicus DEM (Earth Search) | ✅ | — | — | — |
+
+### Hydrography (`esd.hydro`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| HUC geometries (USGS WBD REST) | ✅ | ✅ | — | — |
+| HUC geometries (GEE/USGS WBD) | ✅ | ✅ | ✅ | ✅ |
+| HydroATLAS basins (figshare) | ✅ | ✅ | ✅ | ✅ |
+| HydroBASINS (HydroSHEDS regional zip) | <abbr title="RuntimeError: Unreachable: HTTP 403">❌</abbr> | ✅ | — | — |
+| HydroBASINS (GEE/HydroATLAS) | ✅ | ✅ | — | — |
+| GRDC major river basins (World Bank) | ✅ | ✅ | ✅ | ✅ |
+| GRDC WMO basins | ✅ | <abbr title="ConnectionError: ('Connection aborted.', ConnectionResetError(104, 'Connection r">❌</abbr> | <abbr title="RuntimeError: Unreachable: HTTP 404">❌</abbr> | <abbr title="RuntimeError: Unreachable: HTTP 404">❌</abbr> |
+
+### Climate (`esd.climate`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| ARCO-ERA5 (GCS anonymous) | ✅ | ✅ | ✅ | ✅ |
+| ERA5 (Google Earth Engine) | ✅ | ✅ | ✅ | ✅ |
+| Köppen-Geiger classification (figshare) | ✅ | ✅ | ✅ | ✅ |
 <!-- DATA_STATUS_END -->
 
 ## Installation
@@ -162,10 +200,10 @@ mamba install -c conda-forge easysnowdata
 ```bash
 git clone https://github.com/egagli/easysnowdata.git
 cd easysnowdata
-pixi install          # sets up the environment
-pixi run test-unit    # offline tests (no network, no credentials)
-pixi run test-live    # live tests against the data providers (credentialed ones skip without secrets)
-pixi run docs-serve   # preview the docs locally
+pixi install                          # sets up the environments
+pixi run -e test-py313 test-unit      # offline tests (no network, no credentials)
+pixi run -e test-py313 test-live      # live tests against the data providers (credentialed ones skip without secrets)
+pixi run -e docs docs-serve           # preview the docs locally
 ```
 
 ### Services that require account setup
@@ -182,18 +220,18 @@ Planetary Computer and anonymous GCS access require no credentials.
 ## What is in it
 
 <!-- CATALOG_START -->
-28 products across 8 themes, each with one or more access routes:
+32 products across 8 themes, each with one or more access routes:
 
 | theme | products | open without an account |
 | --- | --- | --- |
-| **climate** | [`era5`](https://egagli.github.io/easysnowdata/catalog/era5.html), [`koppen-geiger`](https://egagli.github.io/easysnowdata/catalog/koppen-geiger.html) | 2 of 2 |
-| **hydro** | [`grdc-major-river-basins`](https://egagli.github.io/easysnowdata/catalog/grdc-major-river-basins.html), [`grdc-wmo-basins`](https://egagli.github.io/easysnowdata/catalog/grdc-wmo-basins.html), [`huc`](https://egagli.github.io/easysnowdata/catalog/huc.html), [`hydrobasins`](https://egagli.github.io/easysnowdata/catalog/hydrobasins.html) | 4 of 4 |
-| **land** | [`esa-worldcover`](https://egagli.github.io/easysnowdata/catalog/esa-worldcover.html), [`forest-cover-fraction`](https://egagli.github.io/easysnowdata/catalog/forest-cover-fraction.html), [`nlcd`](https://egagli.github.io/easysnowdata/catalog/nlcd.html) | 2 of 3 |
-| **optical** | [`hls`](https://egagli.github.io/easysnowdata/catalog/hls.html), [`planetscope`](https://egagli.github.io/easysnowdata/catalog/planetscope.html), [`sentinel-2-l2a`](https://egagli.github.io/easysnowdata/catalog/sentinel-2-l2a.html) | 2 of 3 |
-| **sar** | [`sentinel-1-local-incidence-angle`](https://egagli.github.io/easysnowdata/catalog/sentinel-1-local-incidence-angle.html), [`sentinel-1-rtc`](https://egagli.github.io/easysnowdata/catalog/sentinel-1-rtc.html) | 2 of 2 |
-| **snow** | [`modis-snow`](https://egagli.github.io/easysnowdata/catalog/modis-snow.html), [`mountain-snow-mask`](https://egagli.github.io/easysnowdata/catalog/mountain-snow-mask.html), [`snodas`](https://egagli.github.io/easysnowdata/catalog/snodas.html), [`snow-classification`](https://egagli.github.io/easysnowdata/catalog/snow-classification.html), [`ucla-snow-reanalysis`](https://egagli.github.io/easysnowdata/catalog/ucla-snow-reanalysis.html), [`viirs-snow`](https://egagli.github.io/easysnowdata/catalog/viirs-snow.html) | 4 of 6 |
 | **stations** | [`awdb-stations`](https://egagli.github.io/easysnowdata/catalog/awdb-stations.html), [`cdec-stations`](https://egagli.github.io/easysnowdata/catalog/cdec-stations.html), [`databc-stations`](https://egagli.github.io/easysnowdata/catalog/databc-stations.html), [`nve-stations`](https://egagli.github.io/easysnowdata/catalog/nve-stations.html), [`snow-station-archive`](https://egagli.github.io/easysnowdata/catalog/snow-station-archive.html), [`yukon-stations`](https://egagli.github.io/easysnowdata/catalog/yukon-stations.html) | 5 of 6 |
-| **terrain** | [`chili`](https://egagli.github.io/easysnowdata/catalog/chili.html), [`copernicus-dem`](https://egagli.github.io/easysnowdata/catalog/copernicus-dem.html) | 1 of 2 |
+| **snow** | [`modis-snow`](https://egagli.github.io/easysnowdata/catalog/modis-snow.html), [`mountain-snow-mask`](https://egagli.github.io/easysnowdata/catalog/mountain-snow-mask.html), [`snodas`](https://egagli.github.io/easysnowdata/catalog/snodas.html), [`snow-classification`](https://egagli.github.io/easysnowdata/catalog/snow-classification.html), [`ucla-snow-reanalysis`](https://egagli.github.io/easysnowdata/catalog/ucla-snow-reanalysis.html), [`viirs-snow`](https://egagli.github.io/easysnowdata/catalog/viirs-snow.html) | 4 of 6 |
+| **sar** | [`sentinel-1-local-incidence-angle`](https://egagli.github.io/easysnowdata/catalog/sentinel-1-local-incidence-angle.html), [`sentinel-1-rtc`](https://egagli.github.io/easysnowdata/catalog/sentinel-1-rtc.html) | 2 of 2 |
+| **optical** | [`hls`](https://egagli.github.io/easysnowdata/catalog/hls.html), [`planetscope`](https://egagli.github.io/easysnowdata/catalog/planetscope.html), [`sentinel-2-l2a`](https://egagli.github.io/easysnowdata/catalog/sentinel-2-l2a.html) | 2 of 3 |
+| **terrain** | [`3dep`](https://egagli.github.io/easysnowdata/catalog/3dep.html), [`alos-dem`](https://egagli.github.io/easysnowdata/catalog/alos-dem.html), [`chili`](https://egagli.github.io/easysnowdata/catalog/chili.html), [`copernicus-dem`](https://egagli.github.io/easysnowdata/catalog/copernicus-dem.html), [`nasadem`](https://egagli.github.io/easysnowdata/catalog/nasadem.html), [`srtm`](https://egagli.github.io/easysnowdata/catalog/srtm.html) | 4 of 6 |
+| **land** | [`esa-worldcover`](https://egagli.github.io/easysnowdata/catalog/esa-worldcover.html), [`forest-cover-fraction`](https://egagli.github.io/easysnowdata/catalog/forest-cover-fraction.html), [`nlcd`](https://egagli.github.io/easysnowdata/catalog/nlcd.html) | 2 of 3 |
+| **hydro** | [`grdc-major-river-basins`](https://egagli.github.io/easysnowdata/catalog/grdc-major-river-basins.html), [`grdc-wmo-basins`](https://egagli.github.io/easysnowdata/catalog/grdc-wmo-basins.html), [`huc`](https://egagli.github.io/easysnowdata/catalog/huc.html), [`hydrobasins`](https://egagli.github.io/easysnowdata/catalog/hydrobasins.html) | 4 of 4 |
+| **climate** | [`era5`](https://egagli.github.io/easysnowdata/catalog/era5.html), [`koppen-geiger`](https://egagli.github.io/easysnowdata/catalog/koppen-geiger.html) | 2 of 2 |
 <!-- CATALOG_END -->
 
 Every product's routes, resolution, credentials, licence and health are on its
@@ -211,16 +249,19 @@ inv = esd.stations.inventory(aoi, daily_only=True)
 obs = esd.stations.load(inv, variables=["swe", "snwd"], time="2023-10/2024-09")
 
 # Terrain, SAR and snow water equivalent — lazy, Dask-backed, CRS attached
-dem = esd.terrain.dem.load(aoi)                             # Copernicus GLO-30
+dem = esd.terrain.dem.load(aoi)                             # Copernicus GLO-30 (default)
+dem = esd.terrain.dem.load(aoi, product="3dep")             # or NASADEM, SRTM, 3DEP, ALOS
 s1 = esd.sar.sentinel1.load(aoi, "2024-03", units="dB")     # Sentinel-1 RTC
 swe = esd.snow.snodas.load(aoi, "2024-03")                  # SNODAS, no account
 
-# Optical, masked and turned into a snow index
+# Optical, masked, and a snow index written out rather than hidden in a helper
 s2 = esd.optical.sentinel2.load(aoi, "2024-03", mask="scl-default")
-ndsi = esd.processing.ndsi(s2)
+ndsi = (s2["green"] - s2["swir16"]) / (s2["green"] + s2["swir16"])
 
-# Categorical products carry CF flag attrs, so the legend draws itself
+# Maps with equal aspect, a scale bar and a graticule; legends from CF flags
+esd.plotting.map(dem, cmap="terrain")
 esd.plotting.categorical(esd.land.landcover.load(aoi))
+esd.plotting.timeseries(obs["swe"])                         # calendar dates, units in [ ]
 
 # What is available, and what it needs
 esd.catalog.search("swe")
@@ -228,14 +269,14 @@ esd.catalog.describe("snodas")
 esd.auth.status()
 ```
 
-The pre-0.1 API (`easysnowdata.remote_sensing.get_*`,
-`automatic_weather_stations.StationCollection`, …) still works and emits a
-`DeprecationWarning` naming its replacement. It is removed one minor release
-after 0.1.
+Coming from 0.0.x? The old module API (`remote_sensing.get_*`,
+`automatic_weather_stations.StationCollection`, …) was deprecated in 0.2 and
+removed in 0.3; the [migration guide](https://egagli.github.io/easysnowdata/migration.html)
+maps every old name to its replacement.
 
 ## Documentation
 
-Full API reference and example notebooks: <https://egagli.github.io/easysnowdata>
+Executed example gallery, data catalog and API reference: <https://egagli.github.io/easysnowdata>
 
 ## Contributing
 

{easysnowdata-0.2.0 → easysnowdata-0.3.2}/POTENTIAL_DATA_PRODUCTS_SOURCES_AND_EXAMPLES.md

@@ -276,7 +276,7 @@ re-implement · **reference** = not a product; kept in §E as an access pattern
 | ICESat-2 ATL06/ATL08 | laser altimetry heights | snow depth by differencing | NSIDC · HDF5 · EDL | medium; `icepyx`/`sliderule` exist | **wrap** |
 | S2/HLS snow cover (#9) | NDSI-threshold and let-it-snow style snow maps | turns imagery into a snow product; the most-asked feature | computed | medium | **follow-on** (NDSI first; algorithm links in E.3) |
 | 3DEP 1/3″ and lidar | US 10 m DEM, point clouds | finer terrain for small basins; `py3dep` already a dependency | S3/PC · COG/EPT · none | low | **follow-on** |
-| NASADEM | 30 m void-filled SRTM | alternative DEM where GLO-30 has artefacts | LPCLOUD/PC/GEE | low | **follow-on** |
+| NASADEM | 30 m void-filled SRTM | alternative DEM where GLO-30 has artefacts | PC/GEE | low | **shipped 0.3** as `product="nasadem"`, with SRTM GL1 (`"srtm"`, GEE) and ALOS World 3D (`"alos-dem"`) beside it |
 | Insolation proxies (CHILI, heat load) | topographic radiation indices | aspect control on melt timing (P4's CHILI classes) | GEE; or computed from a DEM with McCune & Keon 2002 | low | **rewrite** (CHILI exists) + **follow-on** (local computation) |
 | Dynamic World | 10 m near-real-time land cover | current-year land cover for masking | GEE | low | **follow-on** |
 | Hansen GFC 2025 | tree cover and loss year | forest change affects snow interception | GEE | low | **follow-on** |

{easysnowdata-0.2.0 → easysnowdata-0.3.2}/README.md

@@ -33,59 +33,96 @@ and a recovery closes it; latency and DMR++ readiness are on the
 [status page](https://egagli.github.io/easysnowdata/status.html).
 
 <!-- DATA_STATUS_START -->
-_Last updated: 2026-09-17 21:39 UTC_  
+_Last updated: 2026-09-22 01:46 UTC_  
 _⚠️ = skipped (credentials not available in this run). Latency and virtualization probes are on the [status page](https://egagli.github.io/easysnowdata/status.html)._
 
-| Data Source | Latest (Sep 17) | Sep 14 | Sep 7 | Aug 31 |
+### Stations (`esd.stations`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
 | :---------- | :------: | :------: | :------: | :------: |
-| AWDB stations (NRCS REST API) | ✅ | — | — | — |
-| CDEC stations (JSON data servlet) | ✅ | — | — | — |
-| BC snow stations (DataBC WFS) | ✅ | — | — | — |
-| NVE stations (HydAPI) | ⚠️ | — | — | — |
-| Yukon stations (AquaCache API) | ✅ | — | — | — |
-| SNOTEL/CCSS station list (GitHub) | ✅ | ✅ | ✅ | ✅ |
-| Snow station archive tarball (global_snow_networks) | ✅ | — | — | — |
-| SNOTEL/CCSS station CSV (GitHub) | ✅ | ✅ | ✅ | ✅ |
-| ARCO-ERA5 (GCS anonymous) | ✅ | ✅ | ✅ | ✅ |
-| ERA5 (Google Earth Engine) | ✅ | ✅ | ✅ | ✅ |
-| Köppen-Geiger classification (figshare) | ✅ | ✅ | ✅ | ✅ |
-| HUC geometries (USGS WBD REST) | ✅ | — | — | — |
-| HUC geometries (GEE/USGS WBD) | ✅ | ✅ | ✅ | ✅ |
-| HydroATLAS basins (figshare) | ✅ | ✅ | ✅ | ✅ |
-| HydroBASINS (HydroSHEDS regional zip) | ✅ | — | — | — |
-| HydroBASINS (GEE/HydroATLAS) | ✅ | — | — | — |
-| GRDC major river basins (World Bank) | ✅ | ✅ | ✅ | ✅ |
-| GRDC WMO basins | <abbr title="ConnectionError: ('Connection aborted.', ConnectionResetError(104, 'Connection r">❌</abbr> | <abbr title="RuntimeError: Unreachable: HTTP 404">❌</abbr> | <abbr title="RuntimeError: Unreachable: HTTP 404">❌</abbr> | <abbr title="RuntimeError: Unreachable: HTTP 404">❌</abbr> |
-| MODIS snow cover MOD10A1F (NASA NSIDC) | ✅ | — | — | — |
-| MODIS snow cover MOD10A1 (Planetary Computer) | ✅ | — | — | — |
+| AWDB stations (NRCS REST API) | ✅ | ✅ | — | — |
+| CDEC stations (JSON data servlet) | ✅ | ✅ | — | — |
+| BC snow stations (DataBC WFS) | ✅ | ✅ | — | — |
+| NVE stations (HydAPI) | <abbr title="RuntimeError: Unreachable: HTTP 401">❌</abbr> | ⚠️ | — | — |
+| Yukon stations (AquaCache API) | ✅ | ✅ | — | — |
+| Snow station inventory (global_snow_networks) | ✅ | ✅ | ✅ | ✅ |
+| Snow station archive tarball (global_snow_networks) | ✅ | ✅ | — | — |
+| Snow station CSV (global_snow_networks) | ✅ | ✅ | ✅ | ✅ |
+
+### Snow (`esd.snow`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| MODIS snow cover MOD10A1F (NASA NSIDC) | ✅ | ✅ | — | — |
+| MODIS snow cover MOD10A1 (Planetary Computer) | ✅ | ✅ | — | — |
 | Mountain snow mask (Zenodo) | ✅ | ✅ | ✅ | ✅ |
-| SNODAS (NSIDC G02158) | ✅ | — | — | — |
+| SNODAS (NSIDC G02158) | ✅ | ✅ | — | — |
 | SNODAS (GEE/Climate Engine) | ✅ | ✅ | ✅ | ✅ |
-| Sturm & Liston snow classification (NSIDC-0768) | ✅ | — | — | — |
+| Sturm & Liston snow classification (NSIDC-0768) | ✅ | ✅ | — | — |
 | Sturm & Liston snow classification (Azure) | ✅ | ✅ | ✅ | ✅ |
-| UCLA Snow Reanalysis (NASA NSIDC) | ✅ | ⚠️ | ⚠️ | ⚠️ |
-| HMA Snow Reanalysis (NASA NSIDC) | ✅ | — | — | — |
-| VIIRS snow cover VNP10A1F (NASA NSIDC) | ✅ | — | — | — |
+| UCLA Snow Reanalysis (NASA NSIDC) | ✅ | ✅ | ⚠️ | ⚠️ |
+| HMA Snow Reanalysis (NASA NSIDC) | ✅ | ✅ | — | — |
+| VIIRS snow cover VNP10A1F (NASA NSIDC) | ✅ | ✅ | — | — |
+
+### SAR (`esd.sar`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| Sentinel-1 RTC (Planetary Computer) | ✅ | ✅ | — | — |
+| Sentinel-1 RTC OPERA (CMR-STAC ASF) | ✅ | ✅ | — | — |
+| Sentinel-1 RTC OPERA (Earth Engine) | ✅ | ✅ | — | — |
+| Sentinel-1 static layers (CMR-STAC ASF) | ✅ | ✅ | — | — |
+| Copernicus DEM for the incidence angle (Planetary Computer) | ✅ | ✅ | — | — |
+| Sentinel-1 GRD angle band (Earth Engine) | ✅ | ✅ | — | — |
+
+### Optical imagery (`esd.optical`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| HLS L30 (CMR-STAC LPCLOUD) | ✅ | ✅ | — | — |
+| HLS S30 (Planetary Computer) | ✅ | ✅ | — | — |
+| PlanetScope (Planet Data API) | <abbr title="DeprecationWarning: Auth.value has been deprecated.">❌</abbr> | ⚠️ | — | — |
+| Sentinel-2 L2A (Planetary Computer) | ✅ | ✅ | — | — |
+| Sentinel-2 L2A (Earth Search) | ✅ | ✅ | — | — |
+
+### Terrain (`esd.terrain`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| CHILI (GEE/CSP ERGo) | ✅ | ✅ | ✅ | ✅ |
+| Copernicus DEM (Planetary Computer) | ✅ | ✅ | ✅ | ✅ |
+| Copernicus DEM (Earth Search) | ✅ | ✅ | — | — |
+
+### Land cover (`esd.land`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
 | Forest cover fraction (Zenodo) | ✅ | ✅ | ✅ | ✅ |
-| Forest cover fraction (GEE/CGLS-LC100) | ✅ | — | — | — |
+| Forest cover fraction (GEE/CGLS-LC100) | ✅ | ✅ | — | — |
 | ESA WorldCover (Planetary Computer) | ✅ | ✅ | ✅ | ✅ |
-| ESA WorldCover (AWS bucket) | ✅ | — | — | — |
-| Annual NLCD (GEE community asset) | ✅ | — | — | — |
+| ESA WorldCover (AWS bucket) | ✅ | ✅ | — | — |
+| Annual NLCD (GEE community asset) | ✅ | ✅ | — | — |
 | NLCD (GEE/USGS) | ✅ | ✅ | ✅ | ✅ |
-| HLS L30 (CMR-STAC LPCLOUD) | ✅ | — | — | — |
-| HLS S30 (Planetary Computer) | ✅ | — | — | — |
-| PlanetScope (Planet Data API) | ⚠️ | — | — | — |
-| Sentinel-2 L2A (Planetary Computer) | ✅ | — | — | — |
-| Sentinel-2 L2A (Earth Search) | ✅ | — | — | — |
-| Sentinel-1 RTC (Planetary Computer) | ✅ | — | — | — |
-| Sentinel-1 RTC OPERA (CMR-STAC ASF) | ✅ | — | — | — |
-| Sentinel-1 RTC OPERA (Earth Engine) | ✅ | — | — | — |
-| Sentinel-1 static layers (CMR-STAC ASF) | ✅ | — | — | — |
-| Copernicus DEM for the incidence angle (Planetary Computer) | ✅ | — | — | — |
-| Sentinel-1 GRD angle band (Earth Engine) | ✅ | — | — | — |
-| CHILI (GEE/CSP ERGo) | ✅ | ✅ | ✅ | ✅ |
-| Copernicus DEM (Planetary Computer) | ✅ | ✅ | ✅ | ✅ |
-| Copernicus DEM (Earth Search) | ✅ | — | — | — |
+
+### Hydrography (`esd.hydro`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| HUC geometries (USGS WBD REST) | ✅ | ✅ | — | — |
+| HUC geometries (GEE/USGS WBD) | ✅ | ✅ | ✅ | ✅ |
+| HydroATLAS basins (figshare) | ✅ | ✅ | ✅ | ✅ |
+| HydroBASINS (HydroSHEDS regional zip) | <abbr title="RuntimeError: Unreachable: HTTP 403">❌</abbr> | ✅ | — | — |
+| HydroBASINS (GEE/HydroATLAS) | ✅ | ✅ | — | — |
+| GRDC major river basins (World Bank) | ✅ | ✅ | ✅ | ✅ |
+| GRDC WMO basins | ✅ | <abbr title="ConnectionError: ('Connection aborted.', ConnectionResetError(104, 'Connection r">❌</abbr> | <abbr title="RuntimeError: Unreachable: HTTP 404">❌</abbr> | <abbr title="RuntimeError: Unreachable: HTTP 404">❌</abbr> |
+
+### Climate (`esd.climate`)
+
+| Data Source | Latest (Sep 21) | Sep 17 | Sep 14 | Sep 7 |
+| :---------- | :------: | :------: | :------: | :------: |
+| ARCO-ERA5 (GCS anonymous) | ✅ | ✅ | ✅ | ✅ |
+| ERA5 (Google Earth Engine) | ✅ | ✅ | ✅ | ✅ |
+| Köppen-Geiger classification (figshare) | ✅ | ✅ | ✅ | ✅ |
 <!-- DATA_STATUS_END -->
 
 ## Installation
@@ -105,10 +142,10 @@ mamba install -c conda-forge easysnowdata
 ```bash
 git clone https://github.com/egagli/easysnowdata.git
 cd easysnowdata
-pixi install          # sets up the environment
-pixi run test-unit    # offline tests (no network, no credentials)
-pixi run test-live    # live tests against the data providers (credentialed ones skip without secrets)
-pixi run docs-serve   # preview the docs locally
+pixi install                          # sets up the environments
+pixi run -e test-py313 test-unit      # offline tests (no network, no credentials)
+pixi run -e test-py313 test-live      # live tests against the data providers (credentialed ones skip without secrets)
+pixi run -e docs docs-serve           # preview the docs locally
 ```
 
 ### Services that require account setup
@@ -125,18 +162,18 @@ Planetary Computer and anonymous GCS access require no credentials.
 ## What is in it
 
 <!-- CATALOG_START -->
-28 products across 8 themes, each with one or more access routes:
+32 products across 8 themes, each with one or more access routes:
 
 | theme | products | open without an account |
 | --- | --- | --- |
-| **climate** | [`era5`](https://egagli.github.io/easysnowdata/catalog/era5.html), [`koppen-geiger`](https://egagli.github.io/easysnowdata/catalog/koppen-geiger.html) | 2 of 2 |
-| **hydro** | [`grdc-major-river-basins`](https://egagli.github.io/easysnowdata/catalog/grdc-major-river-basins.html), [`grdc-wmo-basins`](https://egagli.github.io/easysnowdata/catalog/grdc-wmo-basins.html), [`huc`](https://egagli.github.io/easysnowdata/catalog/huc.html), [`hydrobasins`](https://egagli.github.io/easysnowdata/catalog/hydrobasins.html) | 4 of 4 |
-| **land** | [`esa-worldcover`](https://egagli.github.io/easysnowdata/catalog/esa-worldcover.html), [`forest-cover-fraction`](https://egagli.github.io/easysnowdata/catalog/forest-cover-fraction.html), [`nlcd`](https://egagli.github.io/easysnowdata/catalog/nlcd.html) | 2 of 3 |
-| **optical** | [`hls`](https://egagli.github.io/easysnowdata/catalog/hls.html), [`planetscope`](https://egagli.github.io/easysnowdata/catalog/planetscope.html), [`sentinel-2-l2a`](https://egagli.github.io/easysnowdata/catalog/sentinel-2-l2a.html) | 2 of 3 |
-| **sar** | [`sentinel-1-local-incidence-angle`](https://egagli.github.io/easysnowdata/catalog/sentinel-1-local-incidence-angle.html), [`sentinel-1-rtc`](https://egagli.github.io/easysnowdata/catalog/sentinel-1-rtc.html) | 2 of 2 |
-| **snow** | [`modis-snow`](https://egagli.github.io/easysnowdata/catalog/modis-snow.html), [`mountain-snow-mask`](https://egagli.github.io/easysnowdata/catalog/mountain-snow-mask.html), [`snodas`](https://egagli.github.io/easysnowdata/catalog/snodas.html), [`snow-classification`](https://egagli.github.io/easysnowdata/catalog/snow-classification.html), [`ucla-snow-reanalysis`](https://egagli.github.io/easysnowdata/catalog/ucla-snow-reanalysis.html), [`viirs-snow`](https://egagli.github.io/easysnowdata/catalog/viirs-snow.html) | 4 of 6 |
 | **stations** | [`awdb-stations`](https://egagli.github.io/easysnowdata/catalog/awdb-stations.html), [`cdec-stations`](https://egagli.github.io/easysnowdata/catalog/cdec-stations.html), [`databc-stations`](https://egagli.github.io/easysnowdata/catalog/databc-stations.html), [`nve-stations`](https://egagli.github.io/easysnowdata/catalog/nve-stations.html), [`snow-station-archive`](https://egagli.github.io/easysnowdata/catalog/snow-station-archive.html), [`yukon-stations`](https://egagli.github.io/easysnowdata/catalog/yukon-stations.html) | 5 of 6 |
-| **terrain** | [`chili`](https://egagli.github.io/easysnowdata/catalog/chili.html), [`copernicus-dem`](https://egagli.github.io/easysnowdata/catalog/copernicus-dem.html) | 1 of 2 |
+| **snow** | [`modis-snow`](https://egagli.github.io/easysnowdata/catalog/modis-snow.html), [`mountain-snow-mask`](https://egagli.github.io/easysnowdata/catalog/mountain-snow-mask.html), [`snodas`](https://egagli.github.io/easysnowdata/catalog/snodas.html), [`snow-classification`](https://egagli.github.io/easysnowdata/catalog/snow-classification.html), [`ucla-snow-reanalysis`](https://egagli.github.io/easysnowdata/catalog/ucla-snow-reanalysis.html), [`viirs-snow`](https://egagli.github.io/easysnowdata/catalog/viirs-snow.html) | 4 of 6 |
+| **sar** | [`sentinel-1-local-incidence-angle`](https://egagli.github.io/easysnowdata/catalog/sentinel-1-local-incidence-angle.html), [`sentinel-1-rtc`](https://egagli.github.io/easysnowdata/catalog/sentinel-1-rtc.html) | 2 of 2 |
+| **optical** | [`hls`](https://egagli.github.io/easysnowdata/catalog/hls.html), [`planetscope`](https://egagli.github.io/easysnowdata/catalog/planetscope.html), [`sentinel-2-l2a`](https://egagli.github.io/easysnowdata/catalog/sentinel-2-l2a.html) | 2 of 3 |
+| **terrain** | [`3dep`](https://egagli.github.io/easysnowdata/catalog/3dep.html), [`alos-dem`](https://egagli.github.io/easysnowdata/catalog/alos-dem.html), [`chili`](https://egagli.github.io/easysnowdata/catalog/chili.html), [`copernicus-dem`](https://egagli.github.io/easysnowdata/catalog/copernicus-dem.html), [`nasadem`](https://egagli.github.io/easysnowdata/catalog/nasadem.html), [`srtm`](https://egagli.github.io/easysnowdata/catalog/srtm.html) | 4 of 6 |
+| **land** | [`esa-worldcover`](https://egagli.github.io/easysnowdata/catalog/esa-worldcover.html), [`forest-cover-fraction`](https://egagli.github.io/easysnowdata/catalog/forest-cover-fraction.html), [`nlcd`](https://egagli.github.io/easysnowdata/catalog/nlcd.html) | 2 of 3 |
+| **hydro** | [`grdc-major-river-basins`](https://egagli.github.io/easysnowdata/catalog/grdc-major-river-basins.html), [`grdc-wmo-basins`](https://egagli.github.io/easysnowdata/catalog/grdc-wmo-basins.html), [`huc`](https://egagli.github.io/easysnowdata/catalog/huc.html), [`hydrobasins`](https://egagli.github.io/easysnowdata/catalog/hydrobasins.html) | 4 of 4 |
+| **climate** | [`era5`](https://egagli.github.io/easysnowdata/catalog/era5.html), [`koppen-geiger`](https://egagli.github.io/easysnowdata/catalog/koppen-geiger.html) | 2 of 2 |
 <!-- CATALOG_END -->
 
 Every product's routes, resolution, credentials, licence and health are on its
@@ -154,16 +191,19 @@ inv = esd.stations.inventory(aoi, daily_only=True)
 obs = esd.stations.load(inv, variables=["swe", "snwd"], time="2023-10/2024-09")
 
 # Terrain, SAR and snow water equivalent — lazy, Dask-backed, CRS attached
-dem = esd.terrain.dem.load(aoi)                             # Copernicus GLO-30
+dem = esd.terrain.dem.load(aoi)                             # Copernicus GLO-30 (default)
+dem = esd.terrain.dem.load(aoi, product="3dep")             # or NASADEM, SRTM, 3DEP, ALOS
 s1 = esd.sar.sentinel1.load(aoi, "2024-03", units="dB")     # Sentinel-1 RTC
 swe = esd.snow.snodas.load(aoi, "2024-03")                  # SNODAS, no account
 
-# Optical, masked and turned into a snow index
+# Optical, masked, and a snow index written out rather than hidden in a helper
 s2 = esd.optical.sentinel2.load(aoi, "2024-03", mask="scl-default")
-ndsi = esd.processing.ndsi(s2)
+ndsi = (s2["green"] - s2["swir16"]) / (s2["green"] + s2["swir16"])
 
-# Categorical products carry CF flag attrs, so the legend draws itself
+# Maps with equal aspect, a scale bar and a graticule; legends from CF flags
+esd.plotting.map(dem, cmap="terrain")
 esd.plotting.categorical(esd.land.landcover.load(aoi))
+esd.plotting.timeseries(obs["swe"])                         # calendar dates, units in [ ]
 
 # What is available, and what it needs
 esd.catalog.search("swe")
@@ -171,14 +211,14 @@ esd.catalog.describe("snodas")
 esd.auth.status()
 ```
 
-The pre-0.1 API (`easysnowdata.remote_sensing.get_*`,
-`automatic_weather_stations.StationCollection`, …) still works and emits a
-`DeprecationWarning` naming its replacement. It is removed one minor release
-after 0.1.
+Coming from 0.0.x? The old module API (`remote_sensing.get_*`,
+`automatic_weather_stations.StationCollection`, …) was deprecated in 0.2 and
+removed in 0.3; the [migration guide](https://egagli.github.io/easysnowdata/migration.html)
+maps every old name to its replacement.
 
 ## Documentation
 
-Full API reference and example notebooks: <https://egagli.github.io/easysnowdata>
+Executed example gallery, data catalog and API reference: <https://egagli.github.io/easysnowdata>
 
 ## Contributing