earthkit.climate.atmos.keetch_byram_drought_index

earthkit.climate.atmos.keetch_byram_drought_index(pr: xarray.DataArray | str = 'pr', tasmax: xarray.DataArray | str = 'tasmax', pr_annual: xarray.DataArray | str = 'pr_annual', kbdi0: xarray.DataArray | str | None = None, ds: xarray.Dataset | Any = None, **kwargs: Any) → Any

Keetch-byram drought index (kbdi) for soil moisture deficit.

The KBDI indicates the amount of water necessary to bring the soil moisture content back to field capacity. It is often used in the calculation of the McArthur Forest Fire Danger Index. The method implemented here follows :cite:t:`ffdi-finkele_2006` but limits the maximum KBDI to 203.2 mm, rather than 200 mm, in order to align best with the majority of the literature.

Units:

  • kbdi: mm/day

This function wraps xclim.indicators.atmos.keetch_byram_drought_index.

Parameters:

  • pr (xarray.DataArray | str) – Total rainfall over previous 24 hours [mm/day].

  • tasmax (xarray.DataArray | str) – Maximum temperature near the surface over previous 24 hours [degC].

  • pr_annual (xarray.DataArray | str) – Mean (over years) annual accumulated rainfall [mm/year].

  • kbdi0 (xarray.DataArray | str | None) – Previous KBDI values used to initialise the KBDI calculation [mm/day]. Defaults to 0.

  • ds (xarray.Dataset | Any) – Input dataset.

  • **kwargs (Any) – Additional keyword arguments.

Returns:

The computed index.

Return type:

Any