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

From openwfm
 
(336 intermediate revisions by 5 users not shown)
Line 1: Line 1:
This page tracks activity in the [[WRF-Fire]] software development.
:''Main article: [[WRF-SFIRE user guide]]. To get the software now, see [[How to get WRF-SFIRE]].''


==Wish list==
This page tracks activity in the [[WRF-Fire]] and related software development. All members of the community are welcome to [[Open Wildland Fire Modeling E community Wiki#How to get an account|get an account]] and [http://www.openwfm.org/w/index.php5?title=WRF-Fire_development_notes&action=edit edit].


* Get rid of the ugly includes in the argument lists to get the coefficients down the call chain to the spread rate calculations. Pass the coefficients by pointers defined in a module instead. Declare the pointers in the module, or pass them around in a single derived type argument.
===2004===
* A standalone driver for the fire code that is independent of WRF.
** This is how WRF-Fire was originally developed and such driver was available until late 2008 or so. But, then it fell into disuse and the Fire has grown into the WRF over time.
* Gradual ignition from a point or a line, without limitation on the initial radius.
** The current scheme requires that the ignition area is several fire mesh steps large. When such area ignites all at once, all the heat is output to the atmosphere at once, instead of being output gradually and allowing ground layer circulation to develop over time.
* Canopy fire
** Canopy fire collocated with ground fire is easy. A separate canopy fire would be harder.
* Output to WRF-Chem
** Output of the combustion products into WRF is also needed to visualize smoke.


==In progress==
* Ned Patton and Janice Coen propose WRF-Fire in a [http://www.mmm.ucar.edu/mm5/workshop/ws04/Session9/Patton_Edward.pdf workshop paper]  and formulate the fundamental principles of how to combine WRF with the fire spread model from [[CAWFE]].


* Better quadrature for fuel left
===2005===
** The quadrature is done separately on 4 smaller cells per fire cell. The interpolation of time from ignition to the smaller cells should take into consideration the case when some of the nodes interpolated from are ignited and some are not. Volodymyr Kondratenko, [http://repo.or.cz/w/wrffire.git/shortlog/refs/heads/jm2/fuel branch jm2/fuel]
** 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. Minjeong Kim, [http://repo.or.cz/w/wrffire.git/shortlog/refs/heads/jm2/mkim branch jm2/mkim] [http://repo.or.cz/w/wrffire.git/commit/4cf71f8d9e4309281321ad7d38e4f028a005fa8a last commit]
:This affects the amount of heat output from the cell in the timesteps when the fireline crosses the cell.
* Input to the fire model the gradient rather than terrain height.  This will allow the gradient to be smoothly interpolated in preprocessing in the WPS or in setting up ideal cases. No artificial terrain smoothing is needed. The current scheme interpolates terrain height linearly, and if the mesh the terrain is interpolated from is much coarser than the fire mesh, this results in gradient jumps along the terrain mesh lines. Then, the  fire spread rate jumps along the terrain mesh lines. ''See [[Talk:WRF-Fire wish list#Proposed computation of smooth terrain gradient|discussion]].'' [http://repo.or.cz/w/wrffire.git/shortlog/refs/heads/jm2/grad Branch jm2/grad].
* Read the topography from a file in an ideal run.  Fix/extend surface initialization in ideal cases to allow for defining surface properties like roughness, ground temperature, albedo etc., required by soil models and radiation codes. See [[Talk:WRF-Fire wish list#Proposed input of additional data in ideal run|discussion]].  Adam Kochanski, [http://repo.or.cz/w/wrffire.git/shortlog/refs/heads/adamko/surface branch adamko/surface]
* Support hyperbolic vertical mesh grading in ideal run not only exponential. Adam Kochanski, [http://repo.or.cz/w/wrffire.git/shortlog/refs/heads/adamko/surface branch adamko/surface]


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


* Restart
===2006===
* Walking line ignition (as the fireman walks igniting the fire)
 
* Remove (by default) the warm perturbation (bubble) from atmospheric initializations in idealized case. Modify the code and add namelist variables allowing for ingesting the cold/warm perturbation of a specified size (for people interested in fire propagation in downburst/convective environments) (Adam Kochanski)
* 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 {{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}}
* Ignition controlled from namelist {{WRF-Fire-commit|2439f24ff443ec18c5ff5812af456de30fb24636|Dec 24 2007}}
 
===2008===
* 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}}
* Landfire data conversion {{WRF-Fire-commit|932a2d8b3e926bb193b2af07c1ba6410aa0e7e01|Dec 15 2008}}
 
===2009===
* Distributed memory (halos) {{WRF-Fire-commit|0b5a20e6d0c88a1771a781c57307df252a213a7b|Jan 7 2009}}
* Approved for release by UCD and NCAR under WRF public domain notice {{WRF-Fire-commit|76fac8823d0a81920de150a1061b95cd7717b0a9|Mar 17 2009}}
* 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 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}}
* [[How to visualize WRF-Fire output in Matlab|3D visualization in Matlab]] {{WRF-Fire-commit|9237c5529ee03a53d14c448a5fabefc13704819a|Nov 3 2009}}
* [[How to visualize WRF-Fire output in VisTrails|Visualization in VisTrails]] and [[Supercomputing 2009 Demo]], Nov 15 2009
 
===2010===
* Support for WRF restart {{WRF-Fire-commit|fd0219bce87b332b8abb55558c6323f2fc6dc2be|16 Jan 2010}}
* Control in namelist the initial atmosphere perturbation (bubble) in ideal run, off by default. {{WRF-Fire-commit|993cd88d2e2ec6ed84ada027bf5a483ac686c163|27 Feb 2010}} See  [[Talk:WRF-Fire development notes#Bubble|discussion]].
* Version {{WRF-Fire-commit|b6fe89aeb71d941e91530aafcf2f5b183a44fc37|19 Feb 2010}} [[Fire code in WRF release#3.2|released with WRF 3.2]] on [http://www.mmm.ucar.edu/wrf/users/wrfv3.2/updates-3.2.html Apr 2 2010]
* Hyperbolic vertical mesh grading in ideal run not only exponential. {{WRF-Fire-commit|580450739d07b57467f2ce50e1d898029fa47fca|Mar 9 2010}} 
* Fetch high-resolution geogrid data automatically {{WRF-Fire-commit|3bebc4f46f72de3cbfcebd902879098de1122c23|Apr 27 2010}}
* Walking line ignition (as the fireman walks igniting the fire) {{WRF-Fire-commit|acf57d48e09c66826dd8defc87a6dc800627a2e5|23 May 2010}}
* Basic [[How to visualize WRF-Fire output in VAPOR|visualization in VAPOR]]. {{WRF-Fire-commit|1e710fc81479ea71ed74dd9903da9917fc9dcd93|May 26 2010}}
* Merge git repository with WRF and WPS 3.2  {{WRF-Fire-commit|0c084a8e4efeda74c67f62e79393dcec3b21e2d5|Jun 12 2010}} [http://mailman.ucar.edu/pipermail/wrf-fire/2010-June/000046.html announcement]
* Interpolate the terrain gradient to the fire mesh instead of differencing an interpolated terrain height. {{WRF-Fire-commit|80d70fb74bea0e09ef0f635bd90fbe657582a79d|Jun 14 2010}} See [[Talk:WRF-Fire development notes#Proposed computation of smooth terrain gradient|discussion]].
* Replace includes for fire parameter arrays by a derived type. {{WRF-Fire-commit|38007163901e413a8952abd3d600fc8eba24d103|Jun 14 2010}}. See [[Talk:WRF-Fire development notes#Ugly includes|discussion]].
* Resurrected a standalone driver for the fire code that is independent of WRF for diagnostics. {{WRF-Fire-commit|6464357566b780c12d1d71dc2a144a27ed23217b|20 Jun 2010}} See [[Talk:WRF-Fire development notes#Standalone driver|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 [[Talk:WRF-Fire wish list#Surface Initialization|discussion]]. {{WRF-Fire-commit|5eb128225f87b727f30ce11f9cb07b637fb62786|Jul 6 2010}}
* Reading from a file in an ideal run: {{WRF-Fire-commit|d15ece139d3dbd69badfbb5d1c8f1cb857c53132|land use}}, {{WRF-Fire-commit|8d204c4348509cb2efd185cadc4073971ea95ecc|fuel categories}}, {{WRF-Fire-commit|45415cbb515cd4d7dbe0828b11b51b91bf993ae4|topography}} Jul 22 2010
* Vertical wind profiles in Matlab for diagnostics {{WRF-Fire-commit|bee953f99cdcd5260389fa3ab5ef5a7529770e2e|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. [http://github.com/jbeezley/wrf-fire/blob/76d3724e5ce9a69ba51ed650667058e9e583ae21/wrfv2_fire/phys/module_fr_sfire_driver.F#L1023 Sep 11 2010], added wind reduction factor with defaults per Behave {{WRF-Fire-commit|dce06344012c38151fef29b2924b9fc2de6a71cb|16 Sep 2010}}
* Interpolating geographic coordinates to the fire mesh in WPS {{WRF-Fire-commit|d7ebe29f00b60e03d4f93c1ea0b0013b5f96fb6b|17 Sep 2010}}
* [[How to diagnose fuel properties in WRF-Fire|Rate of spread diagnostics]] {{WRF-Fire-commit|334bf9417b5397ed3692b8f469a4914ed433e051|16 Sep 2010}}.
* Support for NetCDF 4 output files based on HDF5 {{WRF-Fire-commit|06c276f324873bc4c6f82c27298430435989ab97|16 Oct 2010}}.
* Subscale ignition with zero initial radius. See [[Talk:WRF-Fire development notes#Gradual_ignition|discussion]]. {{WRF-Fire-commit|c28da1ac95eda7cda822df60e8051e7500873b19|Nov 2, 2010}}
 
===2011===
* [[Vertical wind interpolation|Vertical log interpolation of the wind to different heights for different fuels]]. See [[Talk:WRF-Fire_development_notes#Wind_interpolation_to_different_heights_for_different_fuels|discussion]]. {{WRF-Fire-commit|72219b996f0dbe6af16cd7afdcc39e036c751156|24 Feb 2011}}
* Ignition time interpolation for better quadrature of fuel left {{WRF-Fire-commit|d9cfc6e0988ed90cc96146a23d65a35bb5bad8d8|March 16, 2011}}. See [[WRF-Fire development notes#Better quadrature for fuel left|discussion]].
* 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]].
* '''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
* 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.'''
*  [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]
* Spread vector and [http://www.forestencyclopedia.net/p/p486 Byram's fire intensity]  to estimate the severity of a potential fire for a fire danger rating map {{WRF-Fire-commit|52c4e1595e08a98059ae33c0592bee3d3c0f2bb4|Aug 26, 2011}}
* Restart from wrfout (cycling=.true.) {{WRF-Fire-commit|2b7c8f19382d5d3269e604bf6ba180a0ed8aec44|Sep 16, 2011}} See [[Talk:WRF-Fire development notes#Restart_from_wrfout|discussion]].
* Spatially variable moisture as a part of WRF input {{WRF-Fire-commit|5a6c4b8c06a0aef126ee60a1541744aaaf62c2e5|Sep 27, 2011}}
* Standalone model running from WRF atmospheric state. {{WRF-Fire-commit|168fbfaa8a62061b51999001dc55162e2ac3a798|Oct 28 2011}} See [[Talk:WRF-Fire development notes#Standalone_driver|discussion]].
 
===2012===
* Integrated [[fuel moisture model]] with input from WRF variables, based on the Canadian fire danger rating system {{WRF-Fire-commit|763044cd62eaaec5b92c14462f6e25bdddf4d643|Mar 10, 2012}}. See [[Talk:WRF-Fire_development_notes#Moisture_model|discussion]].
* [[Coupling with WRF-Chem|Smoke transport by WRF-Chem]] tracer {{WRF-Fire-commit|e7b52ab1baef2565ae1743a25bc1ed7f7f2fc109|April 21, 2012}}
* Multiple fire time steps in a single atmospheric step, for stability with highly heterogenous fuels {{WRF-Fire-commit|773cacd01f4401f69d5ab4a0877e3a0a5a32abad|Mar 30, 2012}}
* Fire area and sensible heat flux defined by bitmap images from a satellite or airborne sensor, in an ideal run  {{WRF-Fire-commit|479c944f05ee22a9cbb5d634594975f48c4bbb4c|Jul 27, 2012}}
* Fixed fire of a circular shape, stationary or moving along a line, with a time varying heat flux {{WRF-Fire-commit|778a0c9b3846140221af539ace052c32570de87b|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 [[Publications#Journal_papers_2|December 17, 2012]]
 
===2013===
* [[Coupling with WRF-Chem]] RADM2 and MOZART models {{WRF-Fire-commit|d00789fe5f80976111024f9cdb03ca63f5900478|Jan 17, 2013}}
*  [[Assimilation of RAWS fuel moisture data]], Apr 25, 2013
* 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
 
===To be continued===
 
 
==See also==
 
* [[How to get WRF-Fire]]
* [[List of WRF-Fire pages]]
* [[Users guide]]
* [[Fire code in WRF release]]
* [[WRF-SFIRE wish list]]


==External links==
==External links==


* [http://repo.or.cz/git-browser/by-commit.html?r=wrffire.git Branches and recent activity]
* {{ccm|Data_assimilation_seminar_to_do_list|Data assimilation seminar to do list}}
* {{ccm|Jan_Mandel/Blog|Jan Mandel's blog}}
* [http://repo.or.cz/git-browser/by-commit.html?r=wrffire.git Commit graph]
* [http://www.mmm.ucar.edu/wrf/WG2/WRF_conventions.html WRF Coding Conventions]
* [http://www.mmm.ucar.edu/wrf/users/tutorial/200807/WRF%20Registry%20and%20Examples.pdf WRF Registry and Examples]
* [http://www.mmm.ucar.edu/wrf/WG2/software_v2/ WRF v2 Software Tools and Documentation]
* [http://www.mmm.ucar.edu/wrf/WG2/software_2.0/registry_schaffer.pdf Description of WRF Registry]


[[Category:WRF-Fire]]
[[Category:WRF-Fire|Development notes]]

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

2009

2010

2011

2012

2013

2014

2015

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

2016

To be continued

See also

External links

Retrieved from "https://wiki.openwfm.org/index.php?title=WRF-Fire/WRF-SFIRE_history&oldid=8470"