easysnowdata.terrain.hillshade.load#

easysnowdata.terrain.hillshade.load(aoi: Any = None, *, source: str | None = None, style: str = 'gray-earth-ocean-drainages', scale: str = '10m', cache: bool = True, chunks: Any = 'easysnowdata-default', **kwargs: Any) → DataArray[source]#

Load Natural Earth shaded relief for aoi (the globe when None).

Parameters:
  • aoi – Any form easysnowdata.aoi.parse_aoi() accepts; None returns the whole globe.

  • source – Only "natural-earth" today.

  • style – "gray-earth-ocean-drainages" (default; 1:10m only), "gray-earth-ocean", "gray-earth-water", "gray-earth" or "shaded-relief" (a plain hillshade). See STYLES.

  • scale – "10m" (default, 1 arcmin) or "50m" (2 arcmin) — Natural Earth’s 1:10 million and 1:50 million scales, not metres.

  • cache – True (default) downloads the zip once into the easysnowdata cache and reads it locally; False reads it over HTTPS every call.

  • chunks – Dask chunks; None loads eagerly.

  • **kwargs – Passed to rioxarray.open_rasterio.

Returns:

xarray.DataArray – hillshade as uint8 brightness (0 dark - 255 light) on latitude/longitude in EPSG:4326, with no nodata.

Examples using easysnowdata.terrain.hillshade.load#

Countries, states, counties and admin units

Countries, states, counties and admin units

Mountain ranges: GMBA Mountain Inventory v2

Mountain ranges: GMBA Mountain Inventory v2

Natural Earth map layers: lakes, rivers, glaciers, places

Natural Earth map layers: lakes, rivers, glaciers, places

Hillshade: Natural Earth shaded relief as a basemap

Hillshade: Natural Earth shaded relief as a basemap