earthkit.climate.atmos.duff_moisture_code

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

Duff moisture code (fwi component).

The duff moisture code is part of the Canadian Forest Fire Weather Index System. It is a numeric rating of the average moisture content of loosely compacted organic layers of moderate depth.

Units:

  • dmc: dimensionless

This function wraps xclim.indicators.atmos.duff_moisture_code.

Parameters:

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

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

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

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

  • snd (xarray.DataArray | str | None) – Noon snow depth.

  • dmc0 (xarray.DataArray | str | None) – Initial values of the duff moisture 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.

  • dry_start (str | None) – Whether to activate the DC and DMC “dry start” mechanism and which method to use. See fire_weather_ufunc().

  • initial_start_up (bool) – If True (default), grid points 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