xrspatial.visibility.cumulative_viewshed#

xrspatial.visibility.cumulative_viewshed(raster: DataArray, observers: list, target_elev: float = 0, max_distance: float = None) → DataArray[source]#

Count how many observers can see each cell.

Parameters:

  • raster (xarray.DataArray) – Elevation raster (numpy, cupy, or dask-backed).

  • observers (list of dict) – Each dict must have x and y keys (data-space coords). Optional keys: observer_elev (default 0), target_elev (overrides function-level default), max_distance (per-observer analysis radius).

  • target_elev (float) – Default target elevation for observers that don’t specify one.

  • max_distance (float, optional) – Default maximum analysis radius.

Returns:

Integer raster (int32) with the count of observers that have line-of-sight to each cell.

Return type:

xarray.DataArray