fwiBAT: Fire Weather Index batch function, Deprecated
In fwi.fbp: Fire Weather Index System and Fire Behaviour Prediction System Calculations
Description
Usage
Arguments
Details
Value
Author(s)
References
Examples
Description
fwiBAT generates Fire Weather Index (FWI) System outputs for one weather station during a continuous period of time. This is a high-level function in which FWI System components are calculated from a list of consecutive (e.g., all days of a fire season). For maximum flexibility, the low-level function fwi should be used.
Usage
1
2
Arguments
input
A dataframe containing input variables of daily weather observations taken at noon LST. Variable names have to be the same as in the following list, but they are case insensitive. The order in which the input variables are entered is not important.
id (optional) Unique identifier of a weather station or spatial point (no restriction on
data type)
lat (recommended) Latitude (decimal degree, default=55)
long (optional) Longitude (decimal degree)
yr (optional) Year of observation
mon (recommended) Month of the year (integer 1-12, default=7)
day (optional) Day of the month (integer)
temp (required) Temperature (centigrade)
rh (required) Relative humidity (%)
ws (required) 10-m height wind speed (km/h)
prec (required) 24-hour rainfall (mm)
init
Initial ("startup") values are provided for the calculation of the first day of a multi-day dataframe. In this case, except for the first day, the function assumed the previous day's conditions to be contained in the previous line of the dataframe (i.e., the previous day).
ffmc_yda Fine Fuel Moisture Code (FFMC; unitless) of the previous day. Default value is 85.
dmc_yda Duff Moisture Code (DMC; unitless) of the previous day. Default value is 6.
dc_yda Drought Code (DC; unitless) of the previous day. Default value is 15.
lat Latitude of the weather station (optional, default=55). Latitude values are used to make
day length adjustments in the function.
out
The function offers two output options, out="all" will produce an output include both the input and the FWI System outputs; out="fwi" will generate only the FWI system components.
lat.adjust
The function offers options for whether day length adjustments should be applied to the calculations. The default value is "TRUE".
Details
The Canadian Forest Fire Weather Index (FWI) System is a major subsystem of the Canadian Forest Fire Danger Rating System, which also includes Canadian Forest Fire Behavior Prediction (FBP) System. The modern FWI System was first issued in 1970 and is the result of work by numerous researchers from across Canada. It evolved from field research which began in the 1930's and regional fire hazard and fire danger tables developed from that early research.
The modern System (Van Wagner 1987) provides six output indices which represent fuel moisture and potential fire behavior in a standard pine forest fuel type. Inputs are a daily noon observation of fire weather, which consists of screen-level air temperature and relative humidity, 10 meter open wind speed and 24 accumulated precipitation.
The first three outputs of the system (the Fire Fuel Moisture Code, the Duff Moisture Code, and the Drought Code) track moisture in different layers of the fuel making up the forest floor. Their calculation relies on the daily fire weather observation and also, importantly, the code value from the previous day as they are in essence bookkeeping systems tracking the amount of moisture (water) in to and out of the layer. It is therefore important that when calculating FWI System outputs over an entire fire season, an uninterrupted daily weather stream is provided; one day is the assumed time step in the models and thus missing data must be filled in.
The next three outputs of the System are relative (unitless) indicators of aspects of fire behavior potential: spread rate (the Initial Spread Index), fuel consumption (the Build-up Index) and fire intensity per unit length of fire front (the Fire Weather Index). This final index, the fwi, is the component of the System used to establish the daily fire danger level for a region and communicated to the public. This final index can be transformed to the Daily Severity Rating (dsr) to provide a more reasonably-scaled estimate of fire control difficulty.
Both the Duff Moisture Code (dmc) and Drought Code (dc) are influenced by day length (see Van Wagner, 1987). Day length adjustments for different ranges in latitude can be used (as described in Lawson and Armitage 2008 (http://cfs.nrcan.gc.ca/pubwarehouse/pdfs/29152.pdf)) and are included in this R function; latitude must be positive in the northern hemisphere and negative in the southern hemisphere.
At the start of a fire season, or simply the start of a daily weather stream, the FWI System calculation requires an estimate of yesterday's moisture conditions. The default initial (i.e., "start-up") fuel moisture code values (FFMC=85, DMC=6, DC=15) provide a reasonable set of conditions for post-snowmelt springtime conditions in eastern/central Canada, the Northern U.S., and Alaska; physically these spring start-up values represent about 3 days of drying from complete moisture saturation of the fuel layer. In areas or years with particularly dry winters (or parts of the world without significant snow cover) these start-up values for FFMC and DMC may still be appropriate as these two elements respond relatively quickly to changes in the weather. The DC component however, because of its very long response time, can take considerable time to adjust to unrealistic initial values and some effort to estimate over-winter value of the DC may be necessary. Users can look again to Lawson and Armitage (2008) for a more detailed description of code calculation startup issues and the over-winter adjustment process.
Value
fwiBAT returns a data.frame which may include both the input and the FWI System outputs (default) or the FWI System outputs only as described below:
Input Variables
May include id, long, lat, yr, mon, day, temp, rh, ws, and prec when option out='all' (default) is chosen
ffmc
Fine Fuel Moisture Code
dmc
Duff Moisture Code
dc
Drought Code
isi
Initial Spread Index
bui
Buildup Index
fwi
Fire Weather Index
dsr
Daily Severity Rating
Author(s)
Xianli Wang, Alan Cantin, Marc-Andre Parisien, Mike Wotton, Kerry Anderson, and Mike Flannigan
References
1. Van Wagner, C.E. and T.L. Pickett. 1985. Equations and FORTRAN program for the Canadian Forest Fire Weather Index System. Can. For. Serv., Ottawa, Ont. For. Tech. Rep. 33. 18 p.
2. Van Wagner, C.E. 1987. Development and structure of the Canadian forest fire weather index system. Forest Technology Report 35. (Canadian Forestry Service: Ottawa).
3. Lawson, B.D. and O.B. Armitage. 2008. Weather guide for the Canadian Forest Fire Danger Rating System. Nat. Resour. Can., Can. For. Serv., North. For. Cent., Edmonton, AB.
Examples
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
library(fwi.fbp)
# The test data is a standard test
# dataset for FWI system(Van Wagner and Pickett 1985).
data("test_fwi")
head(test_fwi)
# using the default initial values
fwi.out<-fwiBAT(test_fwi)
# using a different set of initials
fwi.out<-fwiBAT(test_fwi,init=c(80,10,16,50))
# using only the required input variables:
fwi.out<-fwiBAT(test_fwi[,7:10])
fwi.fbp documentation built on May 1, 2019, 9:23 p.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Description Usage Arguments Details Value Author(s) References Examples
Description
fwiBAT generates Fire Weather Index (FWI) System outputs for one weather station during a continuous period of time. This is a high-level function in which FWI System components are calculated from a list of consecutive (e.g., all days of a fire season). For maximum flexibility, the low-level function fwi should be used.
Usage
1 2 |
Arguments
input |
A dataframe containing input variables of daily weather observations taken at noon LST. Variable names have to be the same as in the following list, but they are case insensitive. The order in which the input variables are entered is not important.
| ||||||||||||||||||||||||||||||||||
init |
Initial ("startup") values are provided for the calculation of the first day of a multi-day dataframe. In this case, except for the first day, the function assumed the previous day's conditions to be contained in the previous line of the dataframe (i.e., the previous day).
| ||||||||||||||||||||||||||||||||||
out |
The function offers two output options, out="all" will produce an output include both the input and the FWI System outputs; out="fwi" will generate only the FWI system components. | ||||||||||||||||||||||||||||||||||
lat.adjust |
The function offers options for whether day length adjustments should be applied to the calculations. The default value is "TRUE". |
Details
The Canadian Forest Fire Weather Index (FWI) System is a major subsystem of the Canadian Forest Fire Danger Rating System, which also includes Canadian Forest Fire Behavior Prediction (FBP) System. The modern FWI System was first issued in 1970 and is the result of work by numerous researchers from across Canada. It evolved from field research which began in the 1930's and regional fire hazard and fire danger tables developed from that early research.
The modern System (Van Wagner 1987) provides six output indices which represent fuel moisture and potential fire behavior in a standard pine forest fuel type. Inputs are a daily noon observation of fire weather, which consists of screen-level air temperature and relative humidity, 10 meter open wind speed and 24 accumulated precipitation.
The first three outputs of the system (the Fire Fuel Moisture Code, the Duff Moisture Code, and the Drought Code) track moisture in different layers of the fuel making up the forest floor. Their calculation relies on the daily fire weather observation and also, importantly, the code value from the previous day as they are in essence bookkeeping systems tracking the amount of moisture (water) in to and out of the layer. It is therefore important that when calculating FWI System outputs over an entire fire season, an uninterrupted daily weather stream is provided; one day is the assumed time step in the models and thus missing data must be filled in.
The next three outputs of the System are relative (unitless) indicators of aspects of fire behavior potential: spread rate (the Initial Spread Index), fuel consumption (the Build-up Index) and fire intensity per unit length of fire front (the Fire Weather Index). This final index, the fwi, is the component of the System used to establish the daily fire danger level for a region and communicated to the public. This final index can be transformed to the Daily Severity Rating (dsr) to provide a more reasonably-scaled estimate of fire control difficulty.
Both the Duff Moisture Code (dmc) and Drought Code (dc) are influenced by day length (see Van Wagner, 1987). Day length adjustments for different ranges in latitude can be used (as described in Lawson and Armitage 2008 (http://cfs.nrcan.gc.ca/pubwarehouse/pdfs/29152.pdf)) and are included in this R function; latitude must be positive in the northern hemisphere and negative in the southern hemisphere.
At the start of a fire season, or simply the start of a daily weather stream, the FWI System calculation requires an estimate of yesterday's moisture conditions. The default initial (i.e., "start-up") fuel moisture code values (FFMC=85, DMC=6, DC=15) provide a reasonable set of conditions for post-snowmelt springtime conditions in eastern/central Canada, the Northern U.S., and Alaska; physically these spring start-up values represent about 3 days of drying from complete moisture saturation of the fuel layer. In areas or years with particularly dry winters (or parts of the world without significant snow cover) these start-up values for FFMC and DMC may still be appropriate as these two elements respond relatively quickly to changes in the weather. The DC component however, because of its very long response time, can take considerable time to adjust to unrealistic initial values and some effort to estimate over-winter value of the DC may be necessary. Users can look again to Lawson and Armitage (2008) for a more detailed description of code calculation startup issues and the over-winter adjustment process.
Value
fwiBAT returns a data.frame which may include both the input and the FWI System outputs (default) or the FWI System outputs only as described below:
Input Variables |
May include id, long, lat, yr, mon, day, temp, rh, ws, and prec when option out='all' (default) is chosen |
ffmc |
Fine Fuel Moisture Code |
dmc |
Duff Moisture Code |
dc |
Drought Code |
isi |
Initial Spread Index |
bui |
Buildup Index |
fwi |
Fire Weather Index |
dsr |
Daily Severity Rating |
Author(s)
Xianli Wang, Alan Cantin, Marc-Andre Parisien, Mike Wotton, Kerry Anderson, and Mike Flannigan
References
1. Van Wagner, C.E. and T.L. Pickett. 1985. Equations and FORTRAN program for the Canadian Forest Fire Weather Index System. Can. For. Serv., Ottawa, Ont. For. Tech. Rep. 33. 18 p.
2. Van Wagner, C.E. 1987. Development and structure of the Canadian forest fire weather index system. Forest Technology Report 35. (Canadian Forestry Service: Ottawa).
3. Lawson, B.D. and O.B. Armitage. 2008. Weather guide for the Canadian Forest Fire Danger Rating System. Nat. Resour. Can., Can. For. Serv., North. For. Cent., Edmonton, AB.
Examples
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | library(fwi.fbp)
# The test data is a standard test
# dataset for FWI system(Van Wagner and Pickett 1985).
data("test_fwi")
head(test_fwi)
# using the default initial values
fwi.out<-fwiBAT(test_fwi)
# using a different set of initials
fwi.out<-fwiBAT(test_fwi,init=c(80,10,16,50))
# using only the required input variables:
fwi.out<-fwiBAT(test_fwi[,7:10])
|
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.