earthkit.climate.atmos.precipitation.griffiths_drought_factor¶
- earthkit.climate.atmos.precipitation.griffiths_drought_factor(pr: xarray.DataArray | str = 'pr', smd: xarray.DataArray | str = 'smd', ds: xarray.Dataset | Any = None, *, limiting_func: str = 'xlim', **kwargs: Any) Any¶
Griffiths drought factor based on the soil moisture deficit.
The drought factor is a numeric indicator of the forest fire fuel availability in the deep litter bed. It is often used in the calculation of the McArthur Forest Fire Danger Index. The method implemented here follows :cite:t:`ffdi-finkele_2006`.
Units:
df: dimensionless
This function wraps xclim.indicators.atmos.griffiths_drought_factor.
- Parameters:
pr (
xarray.DataArray | str) – Total rainfall over previous 24 hours [mm/day].smd (
xarray.DataArray | str) – Daily soil moisture deficit (often KBDI) [mm/day].limiting_func (
str) – How to limit the values of the drought factor. If “xlim” (default), use equation (14) in :cite:t:`ffdi-finkele_2006`. If “discrete”, use equation Eq (13) in :cite:t:`ffdi-finkele_2006`, but with the lower limit of each category bound adjusted to match the upper limit of the previous bound.ds (
xarray.Dataset | Any) – Input dataset.**kwargs (
Any) – Additional keyword arguments.
- Returns:
The computed index.
- Return type:
Any