hillshade

hillshade(xds: str | CloudPath | Path | tuple[ndarray | MaskedArray, dict] | DataArray | Dataset | DatasetReader | DatasetWriter, azimuth: float = 315, zenith: float = 45, **kwargs) → DataArray | Dataset

Compute the hillshade of a DEM from an azimuth and zenith angle (in degrees).

Goal: replace gdaldem CLI

NB: altitude = zenith

References:

• 1

• 2

Parameters:

• xds (AnyRasterType) – Path to the DEM, its dataset, its xarray or a tuple containing its array and metadata

• azimuth (float) – Azimuth of the light, in degrees. 0 if it comes from the top of the raster, 90 from the east, …

• zenith (float) – Zenith angle in degrees

Returns:

Hillshade

Return type:

AnyXrDataStructure