xrspatial.fire.burn_severity_class#

xrspatial.fire.burn_severity_class(dnbr_agg: DataArray, name: str = 'burn_severity_class') → DataArray[source]#

Classify dNBR into USGS 7-class burn severity.

Classes:: 1 = enhanced regrowth (high), 2 = enhanced regrowth (low), 3 = unburned, 4 = low severity, 5 = moderate-low, 6 = moderate-high, 7 = high severity. 0 = nodata.

Supports NumPy, CuPy, Dask with NumPy, and Dask with CuPy backed xarray DataArrays; the output backend matches the input.

Parameters:

dnbr_agg (xr.DataArray or xr.Dataset) – dNBR values (e.g. from dnbr()).
name (str, default='burn_severity_class') – Name of output DataArray.

Returns:

int8 class labels (0-7).

Return type:

xr.DataArray

Examples

>>> import numpy as np, xarray as xr
>>> from xrspatial import burn_severity_class
>>> dnbr_agg = xr.DataArray(
...     np.array([[-0.3, 0.05], [0.3, 0.7]], dtype='f4'))
>>> burn_severity_class(dnbr_agg).values
array([[1, 3],
       [5, 7]], dtype=int8)