Forest fire simulation

What it does

This project implements a simulation of a forest fire in Vue.js and Java Spring Boot.

The forest is represented by a grid h x l. The temporal dimension is discretized, the simulation is step by step. In the initial state, one or several cells are on fire. If a cell is on fire at step t, at t+1:

• The fire goes out in this cell (the cell is filled with ashes and cannot burn anymore)
• There is a probability p for the fire to spread to each 4 adjacent cells

The simulation stops when there are 0 cells on fire. The simulation is restarted when the page is reloaded or when the page is accessed. The Spring Boot server is based on a stateful singleton scope to keep the simulation state across requests for simplicity.

Project structure

The project contains two sub-folders:

• /client the Vue.js client side
• /server the Java Spring Boot server side

Installation and usage

• Inside ./server:

mvn clean install
java -jar target/simulation-0.0.1-SNAPSHOT.jar

The server is accessible on port 8080

• Inside ./client:

npm install
npm run dev

The client is accessible on port 5173 by default and displays the simulation

Configuration file content

The server configuration file is ./server/src/main/resources/application.yml It contains the following variables:

• propagationProbability (between 0 and 1)
• height (of the forest grid)
• width (of the forest grid)
• initialFirePositions (array of {row, column} fire positions)

The client configuration file is ./client/src/config/configuration.js It contains the following variables:

• serverPort (8080)
• simulationDelay (100 ms)