fhProcess: Wrapper for main fhProcessing
In nevilamos/FAMEFMR: Functions For DELWP FAME Fire Analysis

fhProcess

R Documentation

Wrapper for main fhProcessing

Description

Wrapper for main fhProcessing

Usage

fhProcess(
  inFH,
  inFHLayer,
  secondFH,
  secondFHLayer,
  start.SEASON,
  end.SEASON,
  OtherAndUnknown,
  validFIRETYPE,
  max_interval,
  baseFire
)

Arguments

`inFHLayer`	Layer name if inFH has more than one layer ( for instance in a .gpkg) this allows selection of a particular layer, otherwise fist layer is used (Default = NULL)
`secondFH`	Second fire history to be combined with FH1 to make a fire scenario same formats as for inFH
`start.SEASON`	integer First SEASON for which output is wanted (four digit year as integer), if NUll then second season in in history is used (cannot use first season because it has no interval, this may still fail if there is no overlap)
`end.SEASON`	integer Last SEASON required, if NULL then largest value in fire history scenario used
`OtherAndUnknown`	integer Value to use for cases where fire type is: "OTHER" or "UNKNOWN" = NA, "BURN" = 1, "BUSHFIRE" = 2. NA = Fire excluded from analysis. usually set in settings file
`validFIRETYPE`	character vector of valid FIRETYPE values for checking the input file , provided in settings file.
`max_interval`	= NULL #integer number of years maximum inter fire interval after a HIGH fir for which subsequent fire is reassigned to HIGH default is NULL in which case there is no reassignement @param baseFire Default NULL otherwise four digit integer SEASON for fire applied across the whole bounding box
`rawFH`	path to the input fire history geodatabase (".gdb" or ".gpkg") or shapefile (".shp") usually provided in settings
`rawFHLayer`	if rawFH is a geodatabase the name of the layer containing the Fire History if this is not provided and the raw FH is a geodatabase or geopackage then the first layer in the file is returned.

Details

The function takes a shapefile or geopackage layer of Fire history containing polygons with two fields: FIRETYPE and SEASON Where polygons of different FIRETYPE or SEASON overlap the function constructs unique non-overlapping polygon of their intersections ( and non intersecting areas ) and attributes each polygon with sequential fire SEASON (SEAS01, SEAS02 ...) and corresponding FIRETYPE (TYPE01,TYPE02 ...)

It then calculates all the intervals between sequential fires, and Time Since fire (TSF) and Last Fire Type (LFT) and Last burnt year (LBY) for each SEASON as defined in the input arguments, these values are append to the output sf polygon dataframe.