ForeFire

ForeFire is an open-source code for wildland fire spread models, developed and maintained by Université de Corse Pascal Paoli.

Access the demo simulator here

It has been designed and run on Unix systems, three modules can be built with the source code.

The main binaries are

• An interpreter (executable)
• A dynamic library (shared, with C/C++/Java and Fortran bindings)

1. Requirements

The requirements and ForeFire can be installed by running install-forefire.sh (Ubuntu or Debian distributions)

cd forefire

sudo sh install-requirements.sh

The program will be built in: /bin/forefire

OR run the commands:

apt-get update

apt install build-essential -y

apt install libnetcdf-dev libnetcdf-cxx-legacy-dev -y

apt install scons -y

To install

• The C++ compiler (that may come pre-built with your linux distribution)
• NetCDF Library and NetCDF-C++ legacy, for compatibilities issues
• SCons python tool, is used to build the executable and the python library

2. Build

Scons

A sample SConstruct file is included with the distribution. Run it with

cd firefront

scons

Troubleshooting: If it does not work, try using the /tools/Sconstruct file. Replace the Sconstruct file with /tools/Sconstruct. Set the environment variables, and insert the path to the Netcdf (and Java headers for JNI bindings if required).

To build with all warnings enabled

 scons -Q w=1

To make the program executable from eveywhere (during the session) Add the bin folder to path

export PATH=$PATH:./bin

If you want to change it permanently add export PATH=$PATH:</path/to/file> to your ~/.bashrc file

3. Running an example

cd firefront/examples/aullene/

../../bin/forefire -i aullene.ff

The simulation result will be outputed in JSON format

Converting output JSON to GeoJSON

Use the script ff2geojson.py with the .json file as argument.

 python3 py3_tools/ff2geojson.py examples/aullene/1-2009-07-24T15-01-00Z.json

The JSON will be converted to GeoJSON (EPSG 4326) of geometry type MultiPoint and saved in the same directory.

4. Building python Lib

The "swig" repository contains python bindings requires numpy (and numpy.i), swig, and matplotlib for testing.

5. Building with Docker

A sample Dockerfile can allow to build a Docker image with

docker build . -t forefire

To run this image and interactively acces the continer use

docker run -it forefire bash