improver.fire_weather.build_up_index module

improver.fire_weather.build_up_index module#

class BuildUpIndex[source]#

Bases: FireWeatherBase

Plugin to calculate the Build Up Index (BUI).

The BUI is a numerical rating of the total amount of fuel available for combustion. It combines the Duff Moisture Code (DMC) and the Drought Code (DC) to represent the fuel buildup.

This process is adapted directly from:

Equations and FORTRAN Program for the Canadian Forest Fire Weather Index System (C.E. Van Wagner and T.L. Pickett, 1985). Page 7, Equations 27a-27b.

Expected input units:

  • Duff Moisture Code (DMC): dimensionless

  • Drought Code (DC): dimensionless

INPUT_ATTRIBUTE_MAPPINGS: dict[str, str] = {'drought_code': 'input_dc', 'duff_moisture_code': 'input_dmc'}#
INPUT_CUBE_NAMES: list[str] = ['duff_moisture_code', 'drought_code']#
METADATA_SOURCE_CUBE: str = 'drought_code'#
OUTPUT_CUBE_NAME: str = 'build_up_index'#
VALID_OUTPUT_RANGE: tuple[float | None, float | None] | None = (0.0, 500)#
_abc_impl = <_abc._abc_data object>#
_calculate()[source]#

Calculates the Build Up Index (BUI) from DMC and DC.

From Van Wagner and Pickett (1985), Page 7: Equations 27a-27b.

Return type:

ndarray

Returns:

The calculated BUI values.

input_dc: Cube#
input_dmc: Cube#