xrspatial.surface_distance.surface_allocation#
- xrspatial.surface_distance.surface_allocation(raster: DataArray, elevation: DataArray, x: str = 'x', y: str = 'y', target_values: list = [], max_distance: float = inf, connectivity: int = 8, method: str = 'planar') DataArray[source]#
Compute nearest-target allocation along terrain surface.
For each pixel, returns the value of the nearest target pixel by surface distance through the elevation model.
- Parameters:
raster (xr.DataArray or xr.Dataset) – 2-D source raster with target pixels.
elevation (xr.DataArray) – 2-D elevation surface (same shape as raster).
x – See
surface_distance().y – See
surface_distance().target_values – See
surface_distance().max_distance – See
surface_distance().connectivity – See
surface_distance().method – See
surface_distance().
- Returns:
2-D array of allocation values (float32).
- Return type:
xr.DataArray or xr.Dataset