WRF-Fire/WRF-SFIRE history: Difference between revisions

Latest revision as of 02:29, 21 July 2026

Main article: WRF-SFIRE user guide. To get the software now, see How to get WRF-SFIRE.

This page tracks activity in the WRF-Fire and related software development. All members of the community are welcome to get an account and edit.

2004

Ned Patton and Janice Coen propose WRF-Fire in a workshop paper and formulate the fundamental principles of how to combine WRF with the fire spread model from CAWFE.

2005

Standalone fire model from CAWFE rewritten in F90 received from Ned Patton Mar 31 2005.

2006

John Michalakes writes specs for support of fire grids in WRF Feb 6 2006

2007

Alternative implementation of fire grid in nested domains in WRF by Jon Beezley Feb 29 2007
WRF-Fire start: WRF+CAWFE tracers code received from Ned Patton became the initial commit in the WRF-Fire git repository set up by Jon Beezley Jun 6 2007
Matlab prototype of level set method working Aug 30, 2007
Imported a modular rewrite with a new standalone level set code, called SFIRE Sep 5 2007
WRF+spread by level set coupled code working Nov 2 2007
Ignition controlled from namelist Dec 24 2007

2008

Change nodes on the fire mesh from corners to centers Feb 10 2008
WPS support 3 Aug 2008
Github repository https://openwfm/wrf-fire created Oct 10, 2008
MPI support Oct 23 2008
Cleanup, delete standalone driver and the CAWFE tracer code Nov 18 2008
Landfire data conversion Dec 15 2008

2009

Distributed memory (halos) Jan 7 2009
Approved for release by UCD and NCAR under WRF public domain notice Mar 17 2009
Set up nested ideal case May 4 2009
WPS support for fire grid and nesting 7 May 2009
First journal paper with a description of the WRF-Fire Mandel, Beezley, Coen, Kim; June 2009 arXiv p.29ff
Add namelist.fire to define fuel categories 20 Sep 2009
Interpolate in the computation of fuel_left locally to save stack memory Oct 10 2009
3D visualization in Matlab Nov 3 2009
Visualization in VisTrails and Supercomputing 2009 Demo, Nov 15 2009

2010

Support for WRF restart 16 Jan 2010
Control in namelist the initial atmosphere perturbation (bubble) in ideal run, off by default. 27 Feb 2010 See discussion.
Version 19 Feb 2010 released with WRF 3.2 on Apr 2 2010
Hyperbolic vertical mesh grading in ideal run not only exponential. Mar 9 2010
Fetch high-resolution geogrid data automatically Apr 27 2010
Walking line ignition (as the fireman walks igniting the fire) 23 May 2010
Basic visualization in VAPOR. May 26 2010
Merge git repository with WRF and WPS 3.2 Jun 12 2010 announcement
Interpolate the terrain gradient to the fire mesh instead of differencing an interpolated terrain height. Jun 14 2010 See discussion.
Replace includes for fire parameter arrays by a derived type. Jun 14 2010. See discussion.
Resurrected a standalone driver for the fire code that is independent of WRF for diagnostics. 20 Jun 2010 See discussion.
Surface initialization in ideal runs allows for defining surface properties like roughness, ground temperature, albedo etc., required by soil models and radiation codes. See discussion. Jul 6 2010
Reading from a file in an ideal run: land use, fuel categories, topography Jul 22 2010
Vertical wind profiles in Matlab for diagnostics Sun Jul 25 2010
Interpolate wind to a given height (the same for all fuels) from log profile, and set the height as fire_wind_height in the namelist. Sep 11 2010, added wind reduction factor with defaults per Behave 16 Sep 2010
Interpolating geographic coordinates to the fire mesh in WPS 17 Sep 2010
Rate of spread diagnostics 16 Sep 2010.
Support for NetCDF 4 output files based on HDF5 16 Oct 2010.
Subscale ignition with zero initial radius. See discussion. Nov 2, 2010

2011

Vertical log interpolation of the wind to different heights for different fuels. See discussion. 24 Feb 2011
Ignition time interpolation for better quadrature of fuel left March 16, 2011. See discussion.
Added independent adjustment factors of base spread rate, wind correction, and slope correction to fuel description Mar 23, 2011
Perimeter ignition from specified ignition times on the whole domain, allowing for atmosphere and fuel consumption spin-up. Mar 24, 2011 in ideal run. See discussion.
Reference paper discussion version Mandel, Beezley, Kochanski, Coupled atmosphere-wildland fire modeling with WRF-Fire version 3.3, March 9, 2011
WRF-Fire released with WRF 3.3 Apr 6, 2011. The release code is based on the Nov 20, 2010 version with bug fix Jan 17, 2011, with further changes made at NCAR. Last version released with WRF.
Reference paper final version used the name SFIRE. Code continued to be maintained in the original WRF-Fire Git repository.
Timing from ESMF structures to support variable time step and ignition in a restart run. Jul 24, 2011 See discussion.
Users guide moved to the wiki, including existing howtos as chapters. August 2, 2011
Spread vector and Byram's fire intensity to estimate the severity of a potential fire for a fire danger rating map Aug 26, 2011
Restart from wrfout (cycling=.true.) Sep 16, 2011 See discussion.
Spatially variable moisture as a part of WRF input Sep 27, 2011
Standalone model running from WRF atmospheric state. Oct 28 2011 See discussion.

2012

Integrated fuel moisture model with input from WRF variables, based on the Canadian fire danger rating system Mar 10, 2012. See discussion.
Smoke transport by WRF-Chem tracer April 21, 2012
Multiple fire time steps in a single atmospheric step, for stability with highly heterogenous fuels Mar 30, 2012
Fire area and sensible heat flux defined by bitmap images from a satellite or airborne sensor, in an ideal run Jul 27, 2012
Fixed fire of a circular shape, stationary or moving along a line, with a time varying heat flux Jul 29, 2012
Two validation papers accepted: Santa Ana fire arXiv:1202.3209 in Forest Management and Ecology and FireFlux arXiv:1206.3345 in Geoscientific Model Development Discussions December 17, 2012

2013

Coupling with WRF-Chem RADM2 and MOZART models Jan 17, 2013
Assimilation of RAWS fuel moisture data, Apr 25, 2013
Utility for choosing ignition points on the mesh Jun 15, 2013
Reference paper describing new features since 2011 and operational deployment in Israel Oct 9, 2013
Fire model files in WRF source phys/module-fr-sfire-*.F were renamed to phys/module-fr-fire-*.F

2014

Assimilation of RAWS fuel moisture data in standalone

2015

Continued development of WRF-Fire within WRF at NCAR started.

2016

WRF transitioned from SVM source control to GitHub.
Fire replay and cycling Apr 28, 2016
WRF-Fire transitioned to a fork of WRF called WRF-SFIRE, which facilitates upgrades of WRF version. Aug 16, 2016

To be continued

External links

@@ Line 18: / Line 18: @@
 * Alternative implementation of fire grid in nested domains in WRF by Jon Beezley Feb 29 2007
-* WRF+CAWFE tracers code received from Ned Patton became the {{WRF-Fire-commit|b7ed4f2e4cd729c659d086efb86ecaca74919ff8|initial commit}} in the WRF-Fire git repository set up by Jon Beezley Jun 6 2007
+* '''WRF-Fire start''': WRF+CAWFE tracers code received from Ned Patton became the {{WRF-Fire-commit|b7ed4f2e4cd729c659d086efb86ecaca74919ff8|initial commit}} in the WRF-Fire git repository set up by Jon Beezley Jun 6 2007
 * Matlab prototype of level set method working Aug 30, 2007
 * Imported a modular rewrite with a new standalone level set code, called SFIRE {{WRF-Fire-commit|7b72b87820be21e0febba943f7325e66839016e5|Sep 5 2007}}
 * WRF+spread by level set coupled code working {{WRF-Fire-commit|c073b70ef91f4458092cf0a7ecf9163aed5860ea|Nov 2 2007}}
-* Paper with description of WRF-Fire and data assimilation [http://arxiv.org/abs/0712.3965 posted on arXiv Dec 24 2007]
 * Ignition controlled from namelist {{WRF-Fire-commit|2439f24ff443ec18c5ff5812af456de30fb24636|Dec 24 2007}}
@@ Line 28: / Line 27: @@
 * Change nodes on the fire mesh from corners to centers {{WRF-Fire-commit|af413df0557a49ca56db20ff3436b14c7bccee21|Feb 10 2008}}
 * WPS support {{WRF-Fire-commit|94a84b5b0170d8771102ff7fe25040a716268caf|3 Aug 2008}}
+* Github repository https://openwfm/wrf-fire created [https://api.github.com/repos/openwfm/wrf-fire Oct 10, 2008]
 * MPI support {{WRF-Fire-commit|0509e9b746cf671922f1db96667d7f52ab947563|Oct 23 2008}}
 * Cleanup, delete standalone driver and the CAWFE tracer code {{WRF-Fire-commit|a3f839e50ebcf7e068c8aa0266401220bc09f2ec|Nov 18 2008}}
@@ Line 37: / Line 37: @@
 * Set up nested ideal case {{WRF-Fire-commit|aed943498d9ed9c2745151d1f4a63561ed7b5b22|May 4 2009}}
 * WPS support for fire grid and nesting {{WRF-Fire-commit|4c86cf15408046b28a4c725fea80a9fc15ca1a7e|7 May 2009}}
-* First journal paper with a description of the WRF-Fire [http://dx.doi.org/10.1109/MCS.2009.932224 June 2009]
+* '''First journal paper with a description of the WRF-Fire''' [http://dx.doi.org/10.1109/MCS.2009.932224 Mandel, Beezley, Coen, Kim; June 2009][http://arxiv.org/abs/0712.3965v2 arXiv p.29ff]
 * Add namelist.fire to define fuel categories {{WRF-Fire-commit|c978b4ad2e83788d21c72dd93b8ec7eaea5a8c90|20 Sep 2009}}
 * Interpolate in the computation of fuel_left locally to save stack memory {{WRF-Fire-commit|2ac779ca139bd84e5da858a155d1efc2559b238d|Oct 10 2009}}
@@ Line 69: / Line 69: @@
 * Added independent adjustment factors of base spread rate, wind correction, and slope correction to fuel description {{WRF-Fire-commit|43a7425b36dd7fdc4b3784c6827cb7c44605d748|Mar 23, 2011}}
 * Perimeter ignition from specified ignition times on the whole domain, allowing for atmosphere and fuel consumption spin-up. {{WRF-Fire-commit|716cf59c2313e3bb483a57db02211d17b8d095f7|Mar 24, 2011}} in ideal run. See [[Talk:WRF-Fire development notes#Fire spin-up|discussion]].
-* WRF-Fire [http://mailman.ucar.edu/pipermail/wrf-fire/2011-April/000052.html released with WRF 3.3 Apr 6, 2011]. The release code is based on the {{WRF-Fire-commit|fa26d08d8154124ac51514b11bc671eb312e20f8|Nov 20, 2010}} version with bug fix {{WRF-Fire-commit|b964224219585ab198d58510c8f7a0cf129b1990|Jan 17, 2011}}, with [[Changes in WRF-Fire 3.3 release|further changes made at NCAR]].
+* '''Reference paper discussion version''' [https://gmd.copernicus.org/preprints/4/497/2011/gmdd-4-497-2011.pdf Mandel, Beezley, Kochanski, '''Coupled atmosphere-wildland fire modeling with WRF-Fire version 3.3'''], March 9, 2011
-* Started using the name [[SFIRE]] instead of [[WRF-Fire]] for the whole code, June 2011. ''sfire'' was used throughout the code already.
+* WRF-Fire [http://mailman.ucar.edu/pipermail/wrf-fire/2011-April/000052.html released with WRF 3.3 Apr 6, 2011]. The release code is based on the {{WRF-Fire-commit|fa26d08d8154124ac51514b11bc671eb312e20f8|Nov 20, 2010}} version with bug fix {{WRF-Fire-commit|b964224219585ab198d58510c8f7a0cf129b1990|Jan 17, 2011}}, with [[Changes in WRF-Fire 3.3 release|'''further changes made at NCAR''']]. '''Last version released with WRF.'''
-* Reference paper [http://dx.doi.org/10.5194/gmd-4-591-2011 published] in [http://www.geoscientific-model-development.net GMD] July 7, 2011.
+*  [http://dx.doi.org/10.5194/gmd-4-591-2011 '''Reference paper final version'''] used the name SFIRE. Code continued to be maintained in the original [https://api.github.com/repos/openwfm/wrf-fire WRF-Fire Git repository].
 * Timing from [http://www.cesm.ucar.edu/ ESMF] [http://www.mmm.ucar.edu/wrf/users/docs/user_guide/users_guide_chap7.html#_Toc75337319 structures] to support variable time step and ignition in a restart run. {{WRF-Fire-commit|e062dbf62b7591e71a486a7c512efd75e48ed9a1|Jul 24, 2011}} See [[Talk:WRF-Fire development notes#Ignition_Time|discussion]].
 * [[Users guide]] moved to the wiki, including existing [[List of howtos|howtos]] as chapters. [http://www.openwfm.org/w/index.php5?title=Coupled_atmosphere-wildland_fire_model_WRF_and_SFIRE_users%27_guide&action=history August 2, 2011]
@@ Line 92: / Line 92: @@
 * Utility for choosing [[WRF-Fire ignition|ignition points]] on the mesh {{WRF-Fire-commit|e5b6a70fb937534e6cc5868b727fb941bfc04f8a|Jun 15, 2013}}
 * [http://ccm.ucdenver.edu/reports/rep316.pdf Reference paper] describing new features since 2011 and [http://mops.gov.il/English/HomelandSecurityENG/NFServices/Pages/FirePredictionSystem.aspx operational deployment in Israel] Oct 9, 2013
+* Fire model files in WRF source <code>phys/module-fr-sfire-*.F</code> were [https://github.com/wrf-model/WRF/commit/ff7ec687bd82f9d69fed258756e90b809c758f14 renamed] to <code>phys/module-fr-fire-*.F</code>
 ===2014===
 *  [[Assimilation of RAWS fuel moisture data]] in standalone
 ===2015===
+* Continued development of WRF-Fire within WRF at NCAR [https://github.com/wrf-model/WRF/commit/e26f21fb33ecdee7ba3c5640219ddd84a37c6b43 started].
 ===2016===
+* [https://github.com/wrf-model/WRF/commit/8fafea9e9922ec231dfb75e721f83ea78418b57 WRF transitioned] from SVM source control to GitHub.
 * [[Fire replay and cycling]] {{WRF-Fire-commit|efd663a93ad932a5bb3b73d32c5ff8a457d75a85|Apr 28, 2016}}
+* WRF-Fire transitioned to [[Making WRF-Fire repository into a fork WRF-SFIRE of WRF|a fork of WRF]] called [https://github.com/openwfm/WRF-SFIRE WRF-SFIRE], which facilitates upgrades of WRF version. Aug 16, 2016
-==Back burner==
+===To be continued===
-:''Items from the wish list that are around for a long time or may never be done should be moved here.''
-* Merge [http://mailman.ucar.edu/pipermail/wrf-fire/2011-April/000053.html additional changes] [[Fire_code_in_WRF_release#WRF_3.3|made independently in the WRF 3.3 release]].
-* Convert ignition namelist variables into arrays for multiple ignitions.
-* Add running (not colocated with surface fire) canopy fire.
-* Support [http://www.dtcenter.org/wrf-nmm/users/ WRF-NMM] in addition to [http://www.mmm.ucar.edu/wrf/users/ WRF-ARW]
-* Take the winds from a given distance behind the fireline, and set the distance in the namelist.
-* Add fuel models & fuel modeling schemes, esp. Scott-Burgan categories. Input the same fuel description files as [[BehavePlus]] and [[FARSITE]].
-* Generate input data for [[WFDS]].
-==Wish list==
-:''Add your suggestions or plans here. If you want to comment on any of the items, please start a new section of the [[Talk:WRF-Fire development notes|talk page]] and link to it here.''
-* Heat flux extinction depth dependent on fuel type and possibly times step
-* Interpolate by angle between different backing, flank, and forward spread rates.
-* Rework the propagation scheme so that the speed is computed only once per time step instead inside the right-hand-side in the Runge-Kutta method.
-* Add flux limiter option as in [http://fire.nist.gov/bfrlpubs/fire09/art023.html Rehm and McDermott 2009].
-* Flank spread rate as a function of base rate and TKE/turbulent fluxes
-* Turn off artificial diffusion for good
-* Implement full [http://www.forestencyclopedia.net/p/p662/c/c2490/quick_citation_view BURNUP] algorithm instead of the simplification.
-* Keep standalone model working.
-* Add a canopy fire model for passive (colocated with surface fire) canopy fire.
-* Parametrize ignition startup. See [[Talk:WRF-Fire development notes#Parametrized_ignition|discussion]].
-* Input fuel moisture from the WRF surface model. See [[Talk:WRF-Fire_development_notes#Moisture_model|discussion]].
-* Better level set method: High-order ENO and [http://www.math.ucla.edu/~yanovsky/LS.htm WENO], [http://ccm.ucdenver.edu/wiki/Jan_Mandel/Blog/2011_Feb_Mar#February_14:_CCM_Colloquium:_Olivier_Desjardins discontinuous Galerkin].
-* Rewrite the level set method so that the level set function is ignition time minus current time and get rid of the separate '''tign''' array.
-* Use the [http://www.fire.org/index.php?option=com_content&task=category&sectionid=2&id=31&Itemid=295 Fire SDK] to compute ROS.
-* ROS model from [http://dx.doi.org/10.1016/j.combustflame.2009.07.010 Balbi et al 2009].
-* Force the fire to a given location from a file read on restart. This will require fire history replay and atmosphere spin-up.
-* Modify fuel from a file on restart to reflect suppression efforts.
-* Ignition & fire modification from MODIS fire detection.
-* Add fractional fuel volume to fuel categories and generate random fuel coverage.
-* Add other variables in the [[wikipedia:http://en.wikipedia.org/wiki/National_Fire_Danger_Rating_System|National Fire Danger Rating System]] as diagnostics to WRF output.
-==In progress==
-:''When you start on an item from the wish list, please move the item here and add a link to the branch where you work on it.''
-* Clamp ignition point to the nearest cell center to avoid delay, see also [[WRF-Fire ignition]]
-* Fire cell-based fire propagation to get ignition time in lieu of a level-set function {{WRF-Fire-branch|vk/mergge}}
-* Assimilation of station data into the fuel moisture model {{WRF-Fire-branch|mv/moisture}}
-* Ignition from a given fire perimeter, with atmosphere and fuel consumption spin-up, by specifying ignition times. See [[Talk:WRF-Fire development notes#Fire spin-up|discussion]].
-* Real test problems with real fire data comparing fine and coarse resolutions.
-* Better quadrature for fuel left: The current scheme is second order accurate when all 4 corners of a fire mesh cell are on fire, and exact when all 4 corners are not on fire. In the case when only some of the 4 corners are on fire, the only requirements are that the transition when nodes ignite is continuous and monotonous. In that case, the scheme may not be very accurate. A better scheme would be accurate in more cases and have natural invariance properties. {{WRF-Fire-branch|jm2/mkim}} {{WRF-Fire-commit|4cf71f8d9e4309281321ad7d38e4f028a005fa8a|last commit}} {{WRF-Fire-branch|vk/test}}
-:This affects the amount of heat output from the cell in the timesteps when the fireline crosses the cell.
-* {{ccm|Data_assimilation_seminar|Data assimilation}}
-* Dynamically determine midflame height and interpolate the wind there. See [[Talk:WRF-Fire development notes#Fuel height|discussion]].
-==Done==
-:''Move the item here when done and add a link to the contributor's last commit before the merge into master. Links to major milestone events can be also added to the timeline.''
 ==See also==
@@ Line 160: / Line 113: @@
 * [[Users guide]]
 * [[Fire code in WRF release]]
+* [[WRF-SFIRE wish list]]
 ==External links==