Bushfire Attack Level

bal.py

bal - Calculate the bushfire attack level (BAL)

This module is used to produce the bushfire attack level (BAL) for an area of interest within Australia based on input vegetation and elevation datasets as per Method 1 in the Australian Standard AS 3959 (2009) – Construction of buildings in bushfire-prone areas.

moduleauthor:Tina Yang <tina.yang@ga.gov.au>
bal.bal_calc(vegetation, dem, fdi, output_folder, remap, mask)[source]

Calcuate BAL based on vegetation map and DEM.

Parameters:
  • vegetation – file the original vegetation
  • dem – file the input DEM
  • fdi – int the input FDI value
  • output_folder – str the output folder
  • remap – srt the vegetation reclassification
  • mask – file the mask for the effective area of interest (AOI)
bal.find_aoi(extent, dem, veg)[source]

Find the effective area of interest based on input vegetation map, DEM and extent.

Parameters:
  • extent – str the input extent
  • dem – file the input DEM
  • veg – file the input vegetation
Returns:

file the mask for effective AOI
bal.find_common_area(veg_class, slope, aspect)[source]

Find the common area of vegetation, slope and aspect to calculate BAL.

Parameters:
  • veg_class – file the reclassified vegetation
  • slope – file the slope derived from DEM
  • aspect – file the aspect derived from DEM
Returns:

file the vegetation in common area
Returns:

file the slope in common area
Returns:

file the aspect in common area
bal.get_extent_mask(extent, mask)[source]

Derive the mask for the customised input extent.

Parameters:
  • extent – str the input extent
  • mask – file the output mask
bal.get_footprint(raster, footprint)[source]

Find the footprint of a raster

Parameters:
  • raster – file the input raster
  • footprint – file the output footprint
bal.get_slope_aspect(input_dem, output_folder, mask)[source]

Calculate the slope and aspect from the input DEM

Parameters:
  • input_dem – file the input DEM
  • output_folder – str the output folder
  • mask – file the mask for the effective AOI
Returns:

file the reclassified slope
Returns:

file the reclassified aspect
bal.reclass_veg(veg, dem, output_folder, remap, mask)[source]

Reclassify the original vegetation into the categories classified as Table 2.3 in AS 3959 (2009).

Parameters:
  • veg – file the input vegetation
  • dem – file the input dem used as reference projection
  • output_folder – str the output folder
  • remap – srt the vegetation reclassification
  • mask – file the mask for the effective AOI
Returns:

file the reclassified vegetation
bal.run()[source]

Run the BAL calculations.