Difference between revisions of "How to get WRF-SFIRE"

From openwfm
Jump to navigation Jump to search
(note to use this version)
(support notice)
Line 1: Line 1:
 
{{users guide}}
 
{{users guide}}
'''The [http://wrf-model.org WRF] release has an old version of the SFIRE code from 2010. This is true even in newer WRF releases.  Many [[WRF-Fire development notes|errors were fixed and features added]] since then. A [[Fire code in WRF release|detailed  comparison]] of the fire code in the WRF release and the 2010 SFIRE code is available. We highly recommend getting the current version from our repository as described here, which includes current SFIRE and current WRF. We support the current version of SFIRE only and we consider [[WRF-Fire development notes#Wish list|adding features]] on request. We cannot support the version in the WRF release.'''
+
'''The [http://wrf-model.org WRF] release has an old version of the SFIRE code from 2010. This is true even in newer WRF releases.  Many [[WRF-Fire development notes|errors were fixed and features added]] since then. A [[Fire code in WRF release|detailed  comparison]] of the fire code in the WRF release and the 2010 SFIRE code is available. Please get the current version from our repository as described here, which includes current SFIRE and WRF. We support the latest version of SFIRE from our repository only. We can even consider [[WRF-Fire development notes#Wish list|adding features]] on request. Sorry we no longer support the fire code version in the WRF release.'''
  
 
The development version of WRF-Fire is stored in a [[git]] repository, currently hosted in the [http://aws.amazon.com/ec2/ Amazon EC2 cloud].   
 
The development version of WRF-Fire is stored in a [[git]] repository, currently hosted in the [http://aws.amazon.com/ec2/ Amazon EC2 cloud].   

Revision as of 05:57, 3 November 2012

Back to the WRF-SFIRE user guide.

The WRF release has an old version of the SFIRE code from 2010. This is true even in newer WRF releases. Many errors were fixed and features added since then. A detailed comparison of the fire code in the WRF release and the 2010 SFIRE code is available. Please get the current version from our repository as described here, which includes current SFIRE and WRF. We support the latest version of SFIRE from our repository only. We can even consider adding features on request. Sorry we no longer support the fire code version in the WRF release.

The development version of WRF-Fire is stored in a git repository, currently hosted in the Amazon EC2 cloud. A git repository is a software version control system similar to CVS or SVN. In order to obtain the software from our repository, you must first download and install the git software. The default view of the repository is the head of the master branch, which should contain a current stable and working code at any time.

Developers can get write access to the cloud server on request, and must push changes to it.

Download

We strongly recommend to use download by git (as opposed to a tar or zip file, also available from the repository), because git allows easy updates and identification of the state of all files in case of problems. The following public, read-only mirrors are available.

http://github.com/jbeezley/wrf-fire/
git clone git://github.com/jbeezley/wrf-fire.git
http://gitorious.org/wrf-fire
git clone git://gitorious.org/wrf-fire/mainline.git

The home pages of the mirrors allow you to browse the source code as well as examine changes and view the different development branches. It is strongly recommended to use the git:// transport protocol in the git commands as above, not http://, which does not work reliably.

It is also possible to download the latest source code as a tarball or zip file from each mirror; however, this method is discouraged as it will be difficult to update to the latest version.

Update

You can update your files any time to the current version, without downloading all again. If you have downloaded your copy by git, do in your wrf-fire directory

git checkout master; git pull

If you have changed anything, the update will fail, and you have to commit your changes first by git commit -a. The git pull will then merge your changes with the new files from the repository. Please be sure you work with the latest files before contacting us for support. However, we may not be able to support code that you have changed.

Verify

To identify the version of files you have, do in your wrf-fire directory

 git log

To verify your files,

git diff

will give no output if your files have not changed from the version identified by git log.

See also