1. About Fire2a
2. Getting help
3. Contributing
4. Developer setup
   1. Get latest qgis
   2. Get Cell2Fire, python libs and QGIS toolboox-plugin
   3. symlink them
   4. run

We are a team dedicated to finding scientific and technological solutions to mitigate the effects of wildfires. We believe open-source collaboration is key and also providing custom consulting services for real-world organizations. Contact us

Our solutions involve the development of novel methodologies through the integration of various mathematical and technological tools. These tools include machine learning for fire ignition modeling, spatially explicit wildfire simulators, fire risk metrics, species distribution models, stochastic and multiobjective optimization, and simulation-based optimization.

Our goal is create fire-resilient landscapes while minimizing potential carbon emissions, protecting wildlife biodiversity, and ensuring the safety of human communities.

1. Cell2FireW: C++ command line WildFire simulator (forked)

2. Fire-Analytics-ToolBox: Friendly QGIS Processing Toolbox Plugin, interfacing our tools (simulation, optimization, GIS tasks and algorithm, etc.) in various ways, including easy to use clickable dialogs.

3. Algorithms-libs: Python package with algorithms and common GIS tasks.

4. Documentation: User documentation, including QGIS recipes, install & plugin management.

• Outreach contact
• Discord channel
• Getting help tutorial/checklist

All contibutions are welcome, for effectiveness please follow:

• Git etiquette
• Coding style
• Code formatting (each repo has it's own configuration... clang-format, black+friends)
• Issues and Pull Requests minimal consistency:
  1. Check getting help before posting an issue
  2. Pull Requests must be associated to a corresponding issue that explains the motivation for the change and the expected outcome.
  3. Add a comment with an overview of the changes made
  4. One feature/bugfix per pull request
• Scientific citations: Fire research deals with real life or death risks; If your code involves scientific models or calculations, include citations in BibText format. More info Cell2Fire-W/docs/README.md

1. get QGIS
2. get the repos
3. symlink them
4. run

• steps from https://qgis.org/resources/installation-guide/#debianubuntu
• check your distro version $lsb_release -a, below is for Debian 12 (bookworm)

sudo apt install gnupg software-properties-common
sudo mkdir -m755 -p /etc/apt/keyrings  # not needed since apt version 2.4.0 like Debian 12 and Ubuntu 22 or newer
sudo wget -O /etc/apt/keyrings/qgis-archive-keyring.gpg https://download.qgis.org/downloads/qgis-archive-keyring.gpg
# is the suite bookworm ?
echo 'Types: deb deb-src
URIs: https://qgis.org/debian
Suites: bookworm
Architectures: amd64
Components: main
Signed-By: /etc/apt/keyrings/qgis-archive-keyring.gpg' | sudo tee /etc/apt/sources.list.d/qgis.sources
sudo apt update
sudo apt install qgis qgis-plugin-grass

# choose install location
fire=~/fire
mkdir -p $fire

# get cell2fireW
cd $fire
git clone [email protected]:fire2a/C2F-W.git C2F
sudo apt install g++-12 libboost-all-dev libeigen3-dev libtiff-dev
cd C2F/Cell2Fire
make

# get python library
cd $fire
sudo apt install python3-venv 
python3 -m venv venv --system-site-packages # needs system qgis packages
source $fire/venv/bin/activate
git clone [email protected]:fire2a/fire2a-lib.git lib
cd lib
pip install -r requirements.build.txt
pip install -r requirements.code.txt
pip install -r requirements.txt
pip install --editable .

# get toolbox
cd $fire
git clone [email protected]:fire2a/fire-analytics-qgis-processing-toolbox-plugin.git toolbox

# toolbox to QGIS plugins
mkdir -p ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/
cd ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/
ln -s $fire/toolbox/fireanalyticstoolbox .

# c2f to toolbox
cd $fire/toolbox/fireanalyticstoolbox/simulator
ln -s $fire/C2F .

source $fire/venv/bin/activate
qgis
# install the toolbox plugin https://docs.qgis.org/3.4/en/docs/training_manual/qgis_plugins/fetching_plugins.html