fireDynamics: Models flammability dynamics from a weather set

Description Usage Arguments Value

View source: R/flamDynamics.R

Description

Grows the plant community, modelling fire behaviour against a weather dataset for every age, then summarising all behaviour into risk and impact statistics. Allows trees an older age than understorey to represent lower severity fire histories

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
fireDynamics(
  base.params,
  weather,
  growth,
  cover,
  Flora,
  jitters = 5,
  ageStep = 5,
  firstAge = 1,
  steps = 10,
  tAge = 50,
  l = 0.1,
  default.species.params = default.species.params,
  Ms = 0.01,
  Pm = 1,
  Mr = 1.001,
  Hs = 0.2,
  Hr = 1.41,
  a,
  suspNS = "suspNS",
  density = 300,
  test = 80,
  hKill = 90,
  db.path = "out_mc.db",
  updateProgress = NULL
)

Arguments

base.params

Parameter input table

weather

A dataframe with the four fields: tm - Sequential numbering of the records T - Air temperature (deg C) W - Wind velocity (km/h) DFMC - Dead fuel moisture content (proportion ODW)

growth

A dataframe with the six fields: species - Name of the species consistent with other tables max - Maximum plant height (m)

cover

A dataframe with the fields: species - Name of the species consistent with other tables constant - Mean plant separation (m) that does not change with age exp_a - The first constant in an exponential function describing plant separation with tsf exp_b - The second constant in an exponential function describing plant separation with tsf

Flora

A dataframe with the fields: record - a unique, consecutively numbered identifier per site species - the name of the species, which will call trait data from 'default.species.params' moisture - the moisture content of the species in whole numbers (eg 1 for 100 stratum - numeric value from 1 to 4, counting from lowest stratum comp - base, he, ht, top & w - canopy dimensions for that species (m). he and ht are optional clump - mean ratio of clump diameter to crown diameter openness - ratio of gap to clump size

jitters

Number of repetitions for each row in the weather table

ageStep

The number of years between age classes to be examined

firstAge

The youngest age class to be examined

steps

The number of age classes to be examined after firstAge

tAge

The age of trees at the commencement of the run

l

Variation around input leaf dimensions

default.species.params

Leaf traits database

Ms

Standard deviation of LFMC

Pm

Multiplier of mean LFMC

Mr

Truncates LFMC variability by +/- Pm * LFMC

Hs

Standard deviation of plant height variations

Hr

Truncates plant height variability by +/- Hr * height

a

The number of the record to be modelled

suspNS

Name of the fuel in the suspended layer

density

density of the wood in the suspended layer (kg/m3)

test

An isotherm for which the height will be reported

hKill

The percentage of tree canopy above which a risk boundary is crossed (0 - 100)

updateProgress

Progress bar for use in the dashboard

Value

dataframe


pzylstra/Impact documentation built on April 1, 2021, 2:32 a.m.