fwi1D: Fire Weather Index applied to 1D data

Description Usage Arguments Value Daylength adjustment factors FWI spin-up Note Author(s) References

View source: R/fwi1D.R

Description

Implementation of the Canadian Fire Weather Index System for vector data

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
fwi1D(
  dates,
  Tm,
  H,
  r,
  W,
  lat = 46,
  what = "FWI",
  init.pars = c(85, 6, 15),
  spin.up = 0
)

Arguments

dates

Vector of dates. This is a character string in the form d/m/y

Tm

Vector of temperature records (deg. Celsius)

H

Vector of relative humidity records (%)

r

Vector of last 24-h accumulated precipitation (mm)

W

Vector of wind velocity records (Km/h)

lat

Optional. Latitude of the records (in decimal degrees). Default to 46, applying the default parameters of the original FWI System, developed in Canada. See Daylength Adjustment details.

what

Character vector, indicating the components of the FWI system to be returned. Accepted values include any possible subset of the set {"FFMC","DMC","DC" ,"BUI","ISI","FWI","DSR"}. Default to "FWI".

init.pars

A numeric vector of length 3 with the initialization values for the FFMC, DMC and DC components, in this order. Default values as proposed by van Wagner (1987).

spin.up

Non-negative integer indicating the number of days considered for FWI spin-up. Default to 0 (i.e. no spin-up is considered). See the dedicated Section below for further details.

Value

A matrix with the time (days) arranged in rows and the components selected in what in columns. The attribute colnames gives the component ordering. Default to a single-colum matrix returning FWI.

Daylength adjustment factors

By default, the function applies the original FWI daylength adjustment factors for DC and DMC (van Wagner 1987), although it is possible to adjust them by as a function of latitude through the argument lat. The reference values used for each latitudinal range are those indicated in p.71 and Tables A3.1 and A3.2 (p69) in Lawson and Armitage (2008).

FWI spin-up

FWI is initialized with some values for FFMC, DMC and DC components. This means that the first values of the series are not reliable, until the index is iterated over several time steps and stabilizes (typically a few days suffice). Thus, the first index values can be optionally set to NA. The number of days at the beginning of the series to be set to NA is controlled via the spin.up argument.

Note

The FWI system should be computed by definition upon instantaneous values of temperature, relative humidity and wind speed measured a "noon local standar time", plus 24-h accumulated precipitation. The use of inadequate temporal resolution has important implicationas, as highlighted by Herrera et al. (2013). However, prior studies rely on adequate proxies, in order to exploit model databases containing just daily data (see e.g. Bediat et al. (2014)).

Author(s)

Joaquin Bedia-Jiménez

References


ClimInd documentation built on April 10, 2021, 1:06 a.m.