earthkit.climate.atmos.cffwis_indices

earthkit.climate.atmos.cffwis_indices(tas: xarray.DataArray | str = 'tas', pr: xarray.DataArray | str = 'pr', sfcWind: xarray.DataArray | str = 'sfcWind', hurs: xarray.DataArray | str = 'hurs', lat: xarray.DataArray | str = 'lat', snd: xarray.DataArray | str | None = None, ffmc0: xarray.DataArray | str | None = None, dmc0: xarray.DataArray | str | None = None, dc0: xarray.DataArray | str | None = None, season_mask: xarray.DataArray | str | None = None, ds: xarray.Dataset | Any = None, *, season_method: str | None = None, overwintering: bool = False, dry_start: str | None = None, initial_start_up: bool = True, **kwargs: Any) → Any

Canadian fire weather index system indices.

Computes the six (6) fire weather indexes, as defined by the Canadian Forest Service: - The Drought Code - The Duff-Moisture Code - The Fine Fuel Moisture Code - The Initial Spread Index - The Build Up Index - The Fire Weather Index.

Units:

  • dc: dimensionless

  • dmc: dimensionless

  • ffmc: dimensionless

  • isi: dimensionless

  • bui: dimensionless

  • fwi: dimensionless

This function wraps xclim.indicators.atmos.cffwis_indices.

Parameters:

  • tas (xarray.DataArray | str) – Noon temperature.

  • pr (xarray.DataArray | str) – Rain fall in open over previous 24 hours, at noon.

  • sfcWind (xarray.DataArray | str) – Noon wind speed.

  • hurs (xarray.DataArray | str) – Noon relative humidity.

  • lat (xarray.DataArray | str) – Latitude coordinate.

  • snd (xarray.DataArray | str | None) – Noon snow depth, only used if season_method=’LA08’ is passed.

  • ffmc0 (xarray.DataArray | str | None) – Initial values of the fine fuel moisture code.

  • dmc0 (xarray.DataArray | str | None) – Initial values of the Duff moisture code.

  • dc0 (xarray.DataArray | str | None) – Initial values of the drought code.

  • season_mask (xarray.DataArray | str | None) – Boolean mask, True where/when the fire season is active.

  • season_method (str | None) – How to compute the start-up and shutdown of the fire season. If “None”, no start-ups or shutdowns are computed, similar to the R fire function. Ignored if season_mask is given.

  • overwintering (bool) – Whether to activate DC overwintering or not. If True, either season_method or season_mask must be given.

  • dry_start (str | None) – Whether to activate the DC and DMC “dry start” mechanism or not, see fire_weather_ufunc().

  • initial_start_up (bool) – If True (default), gridpoints where the fire season is active on the first timestep go through a start_up phase for that time step. Otherwise, previous codes must be given as a continuing fire season is assumed for those points.

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

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

Returns:

The computed index.

Return type:

Any