USDA Forest Service
 

Logo of the FERA research teamFire and Environmental Research Applications Team

 
 

Fire and Environmental Research Applications Team
Pacific Wildland Fire Sciences Laboratory

400 N 34th Street, Suite 201
Seattle, WA 98103

(206) 732-7800

Logo of the Pacific Northwest Research Station

United States Department of Agriculture Forest Service.

USDA Link Forest Service Link

 

Wildland-Urban Fire Models

These Models are in the Early Stages of Validation

This page contains links to NIST's wildland-urban interface fire computer models and example input files. Validation of these models is ongoing but far from complete. Please keep this in mind when using wfds for problems outside the current scope of validation. See download sections below for information on the current state of validation.

Older Download Links (Executables and Source Code) 

The following links are to builds of FDS that contain a recent version of WFDS capabilites. These links are kept active in case users need to retrieve a the most recent (but not necessarily most current) version. This is sometime necessary if the current version is still being tested. 

Built on May 10, 2010. This implementation is fully incorporated into FDS 5.5.0, SVN Revision Number: 6194. The source code for this build is also available below. NOTE you may have to right click on the appropriate executable and 'save link as'  (Firefox) or 'save target as' (IE); Internet Explorer may prevent downloads.

  1. WINDOWS 
  2. LINUX 
  3. Source Code

 

 

















IV. WFDS for raised fuels (fuel element model for vegetation)

Validation Studies
- Numerical Simulation and Experiments of Burning Douglas Fir Trees Combustion & Flame 156 2023-2041 (2009) This paper also contains a description of the modeling approach and ghe governing equations

The most current version of wfds for Windows, Linux, and OSX (built on November 1, 2010) is within the current version of FDS release (5.5.3), which can be downloaded (along with the most current version of the visualization program Smokeview) at http://code.google.com/p/fds-smv/downloads/list  

Older Download Links (executables and source code) 
The following links are to builds of FDS that contain a recent version of WFDS capabilites. These links are kept active in case users need to retrieve a the most recent (but not necessarily most current) version. This is sometime necessary if the current version is still being tested. 

Built on May 10, 2010. This implementation is fully incorporated into FDS 5.5.0, SVN Revision Number: 6194. The source code for this build is also available below. NOTE you may have to right click on the appropriate executable and 'save link as'  (Firefox) or 'save target as' (IE); Internet Explorer may prevent downloads.
  1. WINDOWS 
  2. LINUX 
  3. Source Code

Input files using fuel element model
Vegetation can be described by a rectangular, conical, cylindrical volume, or a frustum. In the input files below you'll find surface fuels described by a rectangular volume (e.g., pine needles), crown fuels as conical volumes, and tree stems as cylindrical volumes. The stems are present to serve as wind breaks and do not burn. If you are including stems please following the format of the input files.

  1. Fire spread through surface fuel with one tree

Single processor input file:
 input_surf_onetree_1proc.txt

Run by typing (in Windows command window)
wfsd32.exe surf_onetree_1proc.fds

Two processor input file:
input_surf_onetree_2proc.txt

Run by typing (in Windows command window with MPICH2)
mpiexec -n 2 wfds32_mpi.exe surf_onetree_2proc.fds

Burning pine needle bed (5 cm deep), temperature plume, tree foliage, and tree stem. Domain is 16 m long (160 grid cells, dx=10 cm), 3 m wide (30 grid cells, dy=10 cm), and 6 m tall (60 grid cells, dz = 5 cm at ground to 20 cm at top). Mirror or symmetry boundary conditions are used along y = 0 plane. Axes units are meters. Simulation time is 60 s which requires about 2.2 cpu hours. About 200 MB of memory is required.  The 2 processor simulations required 1.2 cpu hours on each processor (total elasped wall clock time was also 1.2 hours, this includes start up and writing out data files).

Smokeview image on left shows particles that represent the surface and tree crown vegetation. Particles are colored according to their temperature value. A vertical slice file with colors showing the gas-phase temperature is also displayed.

Smokeview image on the right uses a solid object to display the cone shaped crown. The solid object is shown by default. This object can be removed in via the Smokeview commands:
Show/Hide -  Geometry - Objects - Canopy.
Particles are loaded or unloaded in Smokeview by: Load/Unload - Particle File - particles
Particle temperature is displayed by: Show/Hide - Particles - Droplet temperature

  1. Fire spread through surface fuel with many trees on flat terrain. No significant crowning. 
 
Single processor input file
input_grass_trees_flat_1proc.txt


Two processor input file:
input_grass_trees_flat_2proc.txt


About 90 identical 6 m tall, 3 m wide, cone shaped trees are randomly distributed across a 30 m wide and 25 m long area. Axesls units are meters. A 0.5 m tall grass is underneath the trees. The grass is ignited on the upwind side. The wind speed is uo = 2 m/s at the x=0 plane.
Grid resolution is 0.5 m in all directions. Note that, unlike the more resolved (~7.5 cm grids) isolated tree simulations, validation of the fuel element model at this resolution has not been completed. The simulation time is 60 s and requires about 25 cpu minutes for a single 3.8 GHz processor run and about  About 200 MB of memory is required. The trees in the above image are colored according to the temperature of the crown vegetation.
  1. Stationary line fire with transport of smoke downwind

input_grass_trees_burner_1proc.txt

Fire, trees, and smoke plume. Same domain size and tree definition as above. Axes units are meters. Fire is held stationary with bed dimensions of 2 m deep by 30 m long with a heat release rate of 500 k/m^2 (based on Australian grassland fires).  Simulation time is 30 s which requires about 9 cpu minutes on a 3.8 GHz processor. About 200 MB of memory is required.


Mock-up of deep fuel bed experiments.
input_deep_fuel_bed_2D.txt

Semi-2D mock up of deep fuel bed experiments. This is preliminary since fuel properties and bulk geometry are unknown. Fire spread is clearly  too fast - which is also due to assuming a 2D geometry. Single processor run required about 3.5 minutes for 60 s simulated time.
3D Run of deep fuel bed experiments, in this case the fuel rows are on on slope
input_deep_fuel_bed_3D.txt



Deep fuel bed simulation in 3D domain 12 m x 10 m x 7 m. Ten meshes are used. When each mesh is assinged a processor (i.e., ten process run) the 180 sec simulation takes about 13 hours (wall clock) with 2.4 GHz, Linux OS.
Simulations of NIST Large Fire Laboratory experiments of Douglas fir tree burns.

Figures at right show snapshots of WFDS simulations of a 2 m tall tree (top) and approximately 5 m tall tree.  In both cases the tree was approximated as cone shaped. A slice file is used to show the gas-phase temperature

The green dots in the lower right quadrant show positions of devices (&DEVC lines in the input files)  that record temperature and heat fluxes for comparison to laboratory measured values.

Mass loss rate was also recorded (by specifying OUTPUT_TREE = .TRUE. on &TREE lines in the input file) and compared to experiments.

The experiments and simulations are described in a paper.

Input files for these cases are below.

2 m tall tree:
input_dfir_2m_14M_4bin_cone.txt

~5 m tall tree
input_dfir_5m_4bin_cone.txt
2m tall tree



5m tall tree
Example of fire spread up a simple hill. Fuel properties are based on Australian grassland fuel.

input_grass_simplehill_fe.txt



Recent changes to the Fuel Element version
  1. How to ouput the dry mass and moisture mass of vegetation .

    In the following text, placed in the input file,

    &HEAD CHID='Test' /
    &TREE PART_ID='foliage', XYZ=0,0,0,FUEL_GEOM='CONE',
                  CROWN_WIDTH=1,CROWN_BASE_HEIGHT=0.3,TREE_HEIGHT=3,
                  OUTPUT_TREE=.TRUE.,LABEL='Tree_1_foliage' /

     the user specifications in HEAD and TREE namelists will result in the output of following columns of data in a text (.csv) file:
    1. time (s)
    2. dry mass of vegetation (kg)
    3.  moisture mass vegetation (kg)
    4. total net convective heat transfer (kW) summed over all fuel elements in the particular &TREE . This measure is the sum of the volume integral of the divergence of the convective heat flux on the fuel element. In other words it is the sum_i integral( divergence of convective heat flux) dVe; where Ve is the volume of the fuel element, and i is the index of the fuel element running from 1 to the number of fuel elements in the computational cell. This is, of course, computed indirectly, the sum is not actually carried out.
    5. total net radiative heat transfer (kW) summed over all fuel elements in the particular &TREE line (i.e., the same computation as was done for the covective heat flux).
The file name will be 'Test_Tree_1_foliage_vegout.csv'. The 'Test' part of the file name is obtained from CHID in the HEAD namelist and the 'Tree_1_foliage'  part of the file name is from LABEL in the TREE namelist. The parameter OUTPUT_TREE must be set to .TRUE. in the TREE namelist.

In addition, the user can specify the time interval between data dumps to the file by the usual use of the DUMP namelist. For example,

&DUMP DT_VEG=0.1 /

will output the dry and moisture mass every 0.1 seconds.

V. WFDS for raised fuels using the boundary fuel model and the current version of FDS

The boundary fuel model is now (as of May 10, 2010) integrated with the current version of FDS (v. 5.5.0). It is still undergoing some testing so use with care and testing. It is obtained by downloading wfds from above . A sample input file is given below. NOTE: the boundary fuel model is undergoing validation tests and should be used with this in consideration.

Validation Studies
  1. Simulation of Australian grassland fires ."A physics based approach to modeling grassland fires." Int'l J. Wildland Fire, 16, 1-22, 2007.
    This paper describes the modeling approach used to represent the surface vegetation. The validation studies in this paper are being repeated for the current version of wfds.
Program Download
The same program is used for the boundary fuel and the fuel element vegetation models. Downloads and source code are in the section above.


Input files for using the boundary fuel model
Example of fire spread up a simple hill. Fuel properties are based on Australian grassland fuel.

input_grass_simplehill_bf.txt

This input file is to illustrate capabilities. This fuel model is still undergoing validation.




VI. WFDS for surface fuels using the boundary fuel model and FDS4 outdated version

WFDS for surface fuels such as grassland fuels (boundary fuel model)
All links below are for a version based on FDS4 and are no loger supported. The boundary fuel model is now in the current version of WFDS as described in the section above
Validation of boundary fuel model to data:
  1. Simulation of Australian grassland fires.
    "A physics based approach to modeling grassland fires." to appear Intn'l J. Wildland Fire.
WFDS program downloads with boundary fuel model
  1. WFDS based on FDS version 4.05 with modifications for fire interaction work
    Serial Parallel
    Windows 32 bit wfds32_bf.exe wfds32_bf_mpi.exe
    Windows 64 bit wfds64_bf.exe wfds64_bf_mpi.exe
    Linux 32 bit wfds32_bf_linux.exe
    Linux 64 bit
    comments run serial wfds by typing
    wfds32_bf.exe < 'input file name' or
    wfds64_bf.exe < 'input file name'

Links to the following versions are inactive.
  1. WFDS based on version 4.05 (February 7, 2005) of FDS:
    1. <>WINDOWS single processor executable wfdsp1_win_bndyfuel.exe  (2.2 MB) <>LINUX single processor wfdsp1_linux_bndryfuel.exe (2.7 MB)
      <>
    2. <>LINUX multiple processor mpi executable wfdsp1_linuxmpi_bndryfuel.exe (3.3 MB)
      run by typing mpirun ##  wfds_linux_5-19-05_fds4p04_mpi.exe >& out & where ## defines the number of processors. NOTE you must have a file named  "fds.data" in the same directory as the executable, this file contains only the name of the input file that WFDS is supposed to read. <><>
Input files with boundary fuel model
Vegetation is present on the bottom of the computational domain as a surface fuel. It can be thought of as being "painted" on. Note that input variable names differ from those in the fuel element model above. Both models will have idential input variable name when then are incorporated into fds5.
  1. Single processor heading and backing fires
    input_2d_VegaHigh.txt
  1. Single processor, two-dimensional grass fire
    input_2d_fireF19.txt

Two-dimensional temperature slice. This case also outputs tracer particles carried by the plume and by the inflow (not shown here). Australian grassland fuel. 200 m (100 grid cells) by 120 m (72 grid cells) domain (2 m horizontal grid resolution, 1.67 vertical resolution). Axes units are meters. Grass is ignited at upwind edge. The wind speed is uo = 3 m/s at a height of zo =2 m and depends on height according to u = (uo)(z/zo)^(1/7).  Simulation time is 60 s (this takes about 1.2 cpu miniutes on a 3.8 GHz processor).  Requires about 68 MB of memory.
  1. Single processor, three-dimensional grass fire using AU grassland fuel
    input_fireC064_1grid.txt

Fire perimenter and smoke plume. Australian grassland fuel parameters. 300 m by 300 m horizontal domain (0.6 m grid resolution); 80 m tall domain (0.6 m cell near ground, stretches to 2.2 m at top). Computational grid is 180(x)  by 180(y) by 72(z); over 2 million cells. Inert fuel break (dark color) surrounds grass. Axes units are meters. Grass is ignited at upwind edge in a time dependent manner (from center out to edges) to recreate field ignition procedures. The wind speed is uo = 7 m/s at a height of zo =2 m and depends on height according to u = (uo)(z/zo)^(1/7). Simulation time is 125 s (this takes about 9.6 cpu hours on a 3.8 GHz processor).  Requires about 1.2 GB of memory.
  1. Two processor, three-dimensional grass fire using AU grassland fuel input_fireC064_2proc.txt

Fire perimeter and smoke plume. The domain is split between the two processors as bordered by the colored lines. Same fuel parameters, domain size, grid resolution as case above (input_fireC064_1grid.txt) but runs on two processors. Axes units are meters. Required 5.6 cpu hours on dual 3.8 GHz processor computer. For details on running with multiple processors see the FDS user guide.
  1. laboratory experiment
    three-dimensional laboratory simulation of fire spread along a pine needle bed.
    input_lab_pineneedles.txt

Fire line and smoke plume is shown. Domain in 4 m (x) by 1.25 m (y) by 2.2 m (z) with 80 (x) by 25 (y) by 45 (z) grid cells. Horizontal grid resolution is 5 cm; vertical starts at 2.5 cm at bottom and stretches to 20 cm at top. The fire spread from left to right in zero ambient wind. Green rectangle shows were the pine needle bed is. The color should change from green to something darker to denote what has been burned. This capability will be added to Smokeview. Simulation time of 300 s required about 3 hours of cpu time on a 3.8 GHz processor;66 MB of memory were required.













































 

U.S. Forest Service - PNW- FERA
Last Modified: 


USDA logo which links to the department's national site. Forest Service logo which links to the agency's national site.