ELMFIRE

https://elmfire.io/
Admin
ELMFIRE is an open-source Eulerian level set wildland fire spread model for forecasting,...
Tokens:29,924
Snippets:382
Trust Score:5.5
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install wget and gRPC

Source: https://elmfire.io/_sources/tutorials/tutorial_03.rst.txt

Install necessary packages for data retrieval. Ensure you have wget and the Python gRPC libraries installed.

```console
sudo apt-get install wget
sudo pip3 install grpcio grpcio-tools
```

--------------------------------

### Install Python Libraries for CloudFire Microservices (Virtualenv)

Source: https://elmfire.io/_sources/getting_started.rst.txt

Sets up a Python virtual environment and installs required libraries within it to avoid system-wide conflicts. Activate the environment before installing packages.

```console
sudo apt-get install python3-virtualenv
virtualenv $HOME/virtualenv/elmfire
source $HOME/virtualenv/elmfire/bin/activate
/$HOME/virtualenv/elmfire/bin/pip3 install google-api-python-client grpcio grpcio-tools \
                                             python-dateutil
```

--------------------------------

### Install wget and gRPC

Source: https://elmfire.io/tutorials/tutorial_03.html

Install necessary packages for data acquisition. This includes wget for downloading and gRPC for communication with Cloudfire services.

```bash
sudo apt-get install wget
sudo pip3 install grpcio grpcio-tools

```

--------------------------------

### Install ELMFIRE Prerequisites

Source: https://elmfire.io/getting_started.html

Installs essential packages required for building and running ELMFIRE.

```bash
sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install -y bc csvkit gdal-bin gfortran git jq libopenmpi-dev \
                        openmpi-bin pigz python3 python3-pip unzip wget zip

```

--------------------------------

### Install ELMFIRE Prerequisites

Source: https://elmfire.io/_sources/getting_started.rst.txt

Installs necessary system packages for building and running ELMFIRE. Ensure your package list is up-to-date before installation.

```console
sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install -y bc csvkit gdal-bin gfortran git jq libopenmpi-dev \
                           openmpi-bin pigz python3 python3-pip unzip wget zip
```

--------------------------------

### Install Python Libraries for CloudFire Microservices (System-wide)

Source: https://elmfire.io/_sources/getting_started.rst.txt

Installs required Python libraries, including gRPC packages, system-wide. Use this method if not using a virtual environment.

```console
sudo pip3 install google-api-python-client grpcio grpcio-tools python-dateutil \
                     --break-system-packages
```

--------------------------------

### Install Python Packages System-Wide

Source: https://elmfire.io/getting_started.html

Installs necessary Python libraries, including gRPC packages, for ELMFIRE microservices.

```bash
sudo pip3 install google-api-python-client grpcio grpcio-tools python-dateutil \
                  --break-system-packages

```

--------------------------------

### ELMFIRE Time Control Namelist Example

Source: https://elmfire.io/_sources/user_guide/io.rst.txt

Configure simulation start/stop times, computational timestep, maximum timestep, and CFL target. Interpolation timesteps for various data types are also set here.

```fortran
&TIME_CONTROL
SIMULATION_TSTART   = 0.0
SIMULATION_TSTOP    = 3600.0
SIMULATION_DT       = 5.0 
SIMULATION_DTMAX    = 600.0
TARGET_CFL          = 0.4
DT_INTERPOLATE_M1   = 300.0
DT_INTERPOLATE_M10  = 3000.0
DT_INTERPOLATE_M100 = 30000.0
DT_INTERPOLATE_MLH  = 9E8
DT_INTERPOLATE_MLW  = 9E8
DT_INTERPOLATE_FMC  = 9E8
DT_INTERPOLATE_WIND = 300.0
/

```

--------------------------------

### Set up Python Virtual Environment for ELMFIRE

Source: https://elmfire.io/getting_started.html

Installs Python packages within a virtual environment to avoid system-wide conflicts.

```bash
sudo apt-get install python3-virtualenv
virtualenv $HOME/virtualenv/elmfire
source $HOME/virtualenv/elmfire/bin/activate
/$HOME/virtualenv/elmfire/bin/pip3 install google-api-python-client grpcio grpcio-tools \
                                           python-dateutil

```

--------------------------------

### Build ELMFIRE Executables

Source: https://elmfire.io/_sources/getting_started.rst.txt

Compiles the ELMFIRE executables and its postprocessing tool. Navigate to the build directory and run the build script. Ensure the installation directory is in your PATH.

```console
cd $ELMFIRE_BASE_DIR/build/linux
./make_gnu.sh
```

--------------------------------

### Configure Surface Fire Spotting by Fuel Model

Source: https://elmfire.io/_sources/user_guide/spotting.rst.txt

This example demonstrates how to selectively enable surface fire spotting for specific fuel model ranges. It disables spotting for most fuel types while enabling it for fuel models 141-149.

```fortran
SURFACE_FIRE_SPOTTING_PERCENT(  1:140) = 0.0
SURFACE_FIRE_SPOTTING_PERCENT(141:149) = 1.0
SURFACE_FIRE_SPOTTING_PERCENT(150:256) = 1.0

```

--------------------------------

### Run Transient Wind Simulation

Source: https://elmfire.io/_sources/tutorials/tutorial_02.rst.txt

Navigate to the tutorial directory and execute the simulation script. This script sets up and runs a fire spread model with transient wind conditions.

```console
cd $ELMFIRE_BASE_DIR/tutorials/02-transient_wind
./01-run.sh
```

--------------------------------

### Run Tutorial 03 Simulation

Source: https://elmfire.io/_sources/tutorials/tutorial_03.rst.txt

Execute the fire spread simulation script for Tutorial 03. This command navigates to the tutorial directory and runs the simulation using pre-configured settings.

```console
cd $ELMFIRE_BASE_DIR/tutorials/03-real-fuels
./01-run.sh
```

--------------------------------

### Define Computational Domain Projection

Source: https://elmfire.io/_sources/user_guide/io.rst.txt

Specify the projection of output files using a proj string, for example, 'EPSG:32610'.

```fortran
A_SRS = 'EPSG:32610'
```

--------------------------------

### Configure Simulation Outputs Directory

Source: https://elmfire.io/_sources/user_guide/io.rst.txt

Set the directory where simulation output files will be saved. Ensure this path is accessible by the simulation.

```fortran
&OUTPUTS
OUTPUTS_DIRECTORY         = './outputs'
```

--------------------------------

### Enable and Configure Spotting

Source: https://elmfire.io/_sources/user_guide/spotting.rst.txt

This snippet shows a sample configuration for the &SPOTTING namelist group, enabling crown fire spotting and defining parameters for spotting distance distribution and ember generation.

```fortran
&SPOTTING
ENABLE_SPOTTING                      = .TRUE.
CROWN_FIRE_SPOTTING_PERCENT          = 1.0
ENABLE_SURFACE_FIRE_SPOTTING         = .TRUE.
SURFACE_FIRE_SPOTTING_PERCENT(:)     = 1.0
CRITICAL_SPOTTING_FIRELINE_INTENSITY = 2000.0
SPOTTING_DISTRIBUTION_TYPE           = 'LOGNORMAL'
MEAN_SPOTTING_DIST                   = 5.0
SPOT_FLIN_EXP                        = 0.3
SPOT_WS_EXP                          = 0.7
NORMALIZED_SPOTTING_DIST_VARIANCE    = 250.0
NEMBERS_MIN                          = 1
NEMBERS_MAX                          = 1
PIGN                                 = 100.0
/

```

--------------------------------

### Configure Simulation Parameters

Source: https://elmfire.io/_sources/tutorials/tutorial_01.rst.txt

Set core simulation parameters including grid size, domain dimensions, and simulation stop time. These values determine the spatial resolution and duration of the simulation.

```console
CELLSIZE=30.0 # Grid size in meters
DOMAINSIZE=12000.0 # Height and width of domain in meters
SIMULATION_TSTOP=22200.0 # Simulation stop time (seconds)
```

--------------------------------

### Run Crown Fire Verification Case

Source: https://elmfire.io/_sources/verification/verification_02.rst.txt

Navigate to the crown fire verification directory and execute the build script. This command initiates the process for testing the crown fire spread model.

```console
cd $ELMFIRE_BASE_DIR/verification/02-crown-fire
./01-build-ellipse.sh
```

--------------------------------

### Enable Initial Attack Suppression

Source: https://elmfire.io/user_guide/suppression.html

Enable initial attack suppression modeling by setting ENABLE_INITIAL_ATTACK to .TRUE. The time of initial attack commencement in seconds must also be specified using INITIAL_ATTACK_TIME.

```fortran
ENABLE_INITIAL_ATTACK = .TRUE.
INITIAL_ATTACK_TIME = 3600.0
```

--------------------------------

### Run Transient Wind Simulation

Source: https://elmfire.io/tutorials/tutorial_02.html

Execute the simulation script for Tutorial 02. This script handles the generation of multiband weather rasters from CSV data.

```bash
cd $ELMFIRE_BASE_DIR/tutorials/02-transient_wind
./01-run.sh

```

--------------------------------

### Enable Initial Attack Suppression

Source: https://elmfire.io/_sources/user_guide/suppression.rst.txt

Enable initial attack suppression modeling by setting the ENABLE_INITIAL_ATTACK flag to TRUE. The time of initial attack commencement must also be specified.

```fortran
ENABLE_INITIAL_ATTACK=.TRUE.
INITIAL_ATTACK_TIME=<time_in_seconds>
```

--------------------------------

### Configure Extended Attack Suppression Parameters

Source: https://elmfire.io/_sources/user_guide/suppression.rst.txt

Configure parameters for the extended attack suppression model. These include constants for SDI calculations, time steps, and area thresholds.

```fortran
B_SDI                      = 1.0
DT_EXTENDED_ATTACK         = 3600.
AREA_NO_CONTAINMENT_CHANGE = 10000.0
MAX_CONTAINMENT_PER_DAY    = 100.0
SDI_FACTOR                 = 1.0
USE_SDI                    = .FALSE.
USE_SDI_LOG_FUNCTION       = .FALSE.
```

--------------------------------

### List Downloaded Shapefile Components

Source: https://elmfire.io/_sources/validation.rst.txt

Lists the files generated by the get_polygon.py script, which typically include .dbf, .prj, .shp, and .shx files.

```bash
$ ls -1 ./out/
```

--------------------------------

### Configure Extended Attack Suppression Parameters

Source: https://elmfire.io/user_guide/suppression.html

Fine-tune the extended attack suppression model using these parameters. USE_SDI and USE_SDI_LOG_FUNCTION control the calculation of the suppression difficulty index.

```fortran
B_SDI                      = 1.0
DT_EXTENDED_ATTACK         = 3600.0
AREA_NO_CONTAINMENT_CHANGE = 10000.0
MAX_CONTAINMENT_PER_DAY    = 100.0
SDI_FACTOR                 = 1.0
USE_SDI                    = .FALSE.
USE_SDI_LOG_FUNCTION       = .FALSE.
```

--------------------------------

### Configure Single Fire Hindcast

Source: https://elmfire.io/validation/validation_01.html

Set simulation parameters for a single fire hindcast, including year, fire name, buffer sizes, ensemble members, run duration, and fuel data source.

```bash
#!/bin/bash

# Specify inputs below:

YEAR=2018
FIRENAME=ca-county
ACTIVE_FIRE_TIMESTAMP_NUM=1
ALREADY_BURNED_TIMESTAMP_NUM=null
WEST_BUFFER=30
SOUTH_BUFFER=30
EAST_BUFFER=30
NORTH_BUFFER=30
NUM_ENSEMBLE_MEMBERS=100
RUN_HOURS=48
FUEL_SOURCE=landfire
FUEL_VERSION=1.4.0
RUN_TEMPLATE=hindcast

export USE_SLURM=no
export CALC_FITNESS=yes

```

--------------------------------

### Single Fire Hindcast Configuration

Source: https://elmfire.io/_sources/validation/validation_01.rst.txt

Configures parameters for a single fire hindcast simulation, including year, fire name, buffering, ensemble size, run duration, fuel source, and run template. Sets environment variables for local execution and fitness calculation.

```bash
#!/bin/bash

# Specify inputs below:

YEAR=2018
FIRENAME=ca-county
ACTIVE_FIRE_TIMESTAMP_NUM=1
ALREADY_BURNED_TIMESTAMP_NUM=null
WEST_BUFFER=30
SOUTH_BUFFER=30
EAST_BUFFER=30
NORTH_BUFFER=30
NUM_ENSEMBLE_MEMBERS=100
RUN_HOURS=48
FUEL_SOURCE=landfire
FUEL_VERSION=1.4.0
RUN_TEMPLATE=hindcast

export USE_SLURM=no
export CALC_FITNESS=yes

# No need to modify from here down:
...
```

--------------------------------

### Build Ellipse Script

Source: https://elmfire.io/_sources/verification/verification_01.rst.txt

This console command navigates to the verification directory and executes a build script to generate GIS data for exact solution ellipses.

```console
cd $ELMFIRE_BASE_DIR/verification/01-elliptical-shape
./01-build-ellipse.sh
```

--------------------------------

### List Fires by Year

Source: https://elmfire.io/_sources/validation.rst.txt

Use the available_polygons.py script to list fires from a specific past year by setting --active=False and --year.

```bash
$ available_polygons.py --list 'fires' --active=False --year=2017
az-brooklyn
az-frye
az-goodwin
az-hilltop
ca-atlas
ca-detwiler
...
```

--------------------------------

### Build ELMFIRE Executables

Source: https://elmfire.io/getting_started.html

Builds the ELMFIRE and ELMFIRE postprocessing executables using the provided build script.

```bash
cd $ELMFIRE_BASE_DIR/build/linux
./make_gnu.sh

```

--------------------------------

### Configure ELMFIRE Spotting with Stochastic Parameters

Source: https://elmfire.io/_sources/user_guide/spotting.rst.txt

This snippet shows a complete `&SPOTTING` namelist configuration enabling stochastic spotting. It defines ranges for parameters that control crown fire spotting, surface fire spotting, and spotting distance distribution. Use this configuration when you want ELMFIRE to randomly generate spotting parameters within specified bounds.

```fortran
&SPOTTING
ENABLE_SPOTTING                          = .TRUE.
STOCHASTIC_SPOTTING                      = .TRUE.
CROWN_FIRE_SPOTTING_PERCENT_MIN          = 0.2
CROWN_FIRE_SPOTTING_PERCENT_MAX          = 0.8
ENABLE_SURFACE_FIRE_SPOTTING             = .TRUE.
GLOBAL_SURFACE_FIRE_SPOTTING_PERCENT_MIN = 0.2 
GLOBAL_SURFACE_FIRE_SPOTTING_PERCENT_MAX = 0.8
CRITICAL_SPOTTING_FIRELINE_INTENSITY     = 2000.0
SPOTTING_DISTRIBUTION_TYPE               = 'LOGNORMAL'
MEAN_SPOTTING_DIST_MIN                   = 5.0
MEAN_SPOTTING_DIST_MAX                   = 10.0
NORMALIZED_SPOTTING_DIST_VARIANCE_MIN    = 250.0
NORMALIZED_SPOTTING_DIST_VARIANCE_MAX    = 600.0
SPOT_WS_EXP_LO                           = 0.4
SPOT_WS_EXP_HI                           = 0.7
SPOT_FLIN_EXP_LO                         = 0.2
SPOT_FLIN_EXP_HI                         = 0.4
NEMBERS_MIN                              = 1
NEMBERS_MAX_LO                           = 1
NEMBERS_MAX_HI                           = 1
PIGN_MIN                                 = 100.0
PIGN_MAX                                 = 100.0
/

```

--------------------------------

### Meteorological Input Data (wx.csv)

Source: https://elmfire.io/_sources/tutorials/tutorial_04.rst.txt

Defines spatially uniform wind speed, direction, and fuel moisture conditions for fire potential calculations. Each row represents a different combination of these parameters.

```console
ws,wd,m1,m10,m100,lh,lw
0,0,2,3,4,30,60
5,0,2,3,4,30,60
10,0,2,3,4,30,60
15,0,2,3,4,30,60
20,0,2,3,4,30,60
25,0,2,3,4,30,60
```

--------------------------------

### Run Basic Fire Simulation

Source: https://elmfire.io/_sources/tutorials/tutorial_01.rst.txt

Execute the main BASH script to create inputs, run ELMFIRE, and perform post-processing for a simple fire spread simulation.

```console
cd $ELMFIRE_BASE_DIR/tutorials/01-constant-wind
./01-run.sh
```

--------------------------------

### List Active Fires

Source: https://elmfire.io/_sources/validation.rst.txt

Use the available_polygons.py script to list active fires. Ensure the script is in your PATH.

```bash
$ available_polygons.py --list 'fires' --active=True
fl-hungryland
fl-pine-wood
ky-cane-fork
```

--------------------------------

### Run Fire Spread Simulation

Source: https://elmfire.io/tutorials/tutorial_03.html

Execute the fire spread simulation script. This script sets up and runs a point ignition using the previously acquired fuel data and conditions from Tutorial 02.

```bash
cd $ELMFIRE_BASE_DIR/tutorials/03-real-fuels
./01-run.sh

```

--------------------------------

### Download Fire Perimeter Shapefile

Source: https://elmfire.io/_sources/validation.rst.txt

Downloads a fire perimeter shapefile for a specified fire name and timestamp. Output files are saved to the specified directory.

```bash
$ get_polygon.py --firename='ca-detwiler' --timestamp='20170717_202600' --outdir='./out' >& /dev/null
```

--------------------------------

### Define Simulation Grid and Domain

Source: https://elmfire.io/tutorials/tutorial_01.html

Set the grid cell size, computational domain dimensions, and simulation stop time. These parameters define the spatial resolution and duration of the simulation.

```bash
CELLSIZE=30.0 # Grid size in meters
DOMAINSIZE=12000.0 # Height and width of domain in meters
SIMULATION_TSTOP=22200.0 # Simulation stop time (seconds)

```

--------------------------------

### ELMFIRE Output Configuration

Source: https://elmfire.io/user_guide/io.html

Configure the directory for ELMFIRE outputs and specify which data to dump. Ensure the output directory exists before running.

```fortran
&OUTPUTS
OUTPUTS_DIRECTORY         = './outputs'
DTDUMP                    = 3600.
DUMP_FLIN                 = .TRUE.
DUMP_SPREAD_RATE          = .TRUE.
DUMP_SURFACE_FIRE         = .TRUE.
DUMP_TIME_OF_ARRIVAL      = .TRUE.
/


```

--------------------------------

### Enable Population Density Asset at Risk Calculation

Source: https://elmfire.io/_sources/user_guide/io.rst.txt

Set USE_POPULATION_DENSITY to .TRUE. to include population density in risk assessment. Specify the population density raster filename using POPULATION_DENSITY_FILENAME.

```fortran
USE_POPULATION_DENSITY = .TRUE.
```

--------------------------------

### Setting Input Parameters for get_polygons.py

Source: https://elmfire.io/validation/validation_01.html

Defines essential parameters for the `get_polygons.py` script to retrieve fire perimeter GIS data, including year, fire name, and timestamp numbers for active and burned areas. Buffers around the fire perimeter can also be specified.

```bash
YEAR=2018
FIRENAME=ca-county
ACTIVE_FIRE_TIMESTAMP_NUM=0
ALREADY_BURNED_TIMESTAMP_NUM=null
WEST_BUFFER=10
SOUTH_BUFFER=10
EAST_BUFFER=10
NORTH_BUFFER=10
```

--------------------------------

### Virtual Weather Station Configuration

Source: https://elmfire.io/user_guide/io.html

Specify the number of virtual weather stations and their coordinates to log detailed environmental data during the simulation. Note: Virtual stations are temporarily disabled.

```fortran
NUM_VIRTUAL_STATIONS = 2
VIRTUAL_STATION_X(1) = 12345.0
VIRTUAL_STATION_Y(1) = 67890.0
VIRTUAL_STATION_X(2) = 98765.0
VIRTUAL_STATION_Y(2) = 43210.0


```

--------------------------------

### Time Control Namelist

Source: https://elmfire.io/user_guide/io.html

Configure simulation duration, timestep, and interpolation frequencies using the &TIME_CONTROL namelist. Ensure units are consistent, typically seconds.

```fortran
&TIME_CONTROL
SIMULATION_TSTART   = 0.0
SIMULATION_TSTOP    = 3600.0
SIMULATION_DT       = 5.0
SIMULATION_DTMAX    = 600.0
TARGET_CFL          = 0.4
DT_INTERPOLATE_M1   = 300.0
DT_INTERPOLATE_M10  = 3000.0
DT_INTERPOLATE_M100 = 30000.0
DT_INTERPOLATE_MLH  = 9E8
DT_INTERPOLATE_MLW  = 9E8
DT_INTERPOLATE_FMC  = 9E8
DT_INTERPOLATE_WIND = 300.0
/

```

--------------------------------

### Navigate to Validation Directory

Source: https://elmfire.io/_sources/validation/validation_01.rst.txt

Change the current directory to the location of the single fire validation case.

```bash
cd $ELMFIRE_BASE_DIR/validation/01-single-fire
```

--------------------------------

### Enable Land Value Asset at Risk Calculation

Source: https://elmfire.io/_sources/user_guide/io.rst.txt

Set USE_LAND_VALUE to .TRUE. to include land value in risk assessment. Specify the land value raster filename using LAND_VALUE_FILENAME.

```fortran
USE_LAND_VALUE = .TRUE.
```

--------------------------------

### Specify Live Fuel Moisture and Spatial Reference System

Source: https://elmfire.io/_sources/tutorials/tutorial_01.rst.txt

Set the moisture content for live herbaceous and woody fuels, and define the spatial reference system for the simulation inputs.

```console
LH_MOISTURE_CONTENT=30.0 # Live herbaceous moisture content, percent
LW_MOISTURE_CONTENT=60.0 # Live woody moisture content, percent
A_SRS="EPSG: 32610" # Spatial reference system - UTM Zone 10
```

--------------------------------

### Configure ELMFIRE Environment Variables

Source: https://elmfire.io/getting_started.html

Exports essential environment variables for ELMFIRE configuration by adding them to ~/.bashrc.

```bash
export ELMFIRE_SCRATCH_BASE=/scratch/clauten
export ELMFIRE_BASE_DIR=/home/clauten/elmfire
export ELMFIRE_INSTALL_DIR=$ELMFIRE_BASE_DIR/build/linux/bin
export CLOUDFIRE_SERVER=worldgen.cloudfire.io
export PATH=$PATH:$ELMFIRE_INSTALL_DIR:$ELMFIRE_BASE_DIR/cloudfire

```

--------------------------------

### Enable Real Estate Value Asset at Risk Calculation

Source: https://elmfire.io/_sources/user_guide/io.rst.txt

Set USE_REAL_ESTATE_VALUE to .TRUE. to include real estate value in risk assessment. Specify the real estate value raster filename using REAL_ESTATE_VALUE_FILENAME.

```fortran
USE_REAL_ESTATE_VALUE = .TRUE.
```

--------------------------------

### Point Source Ignitions Configuration

Source: https://elmfire.io/user_guide/io.html

Specify multiple ignition points for fire spread simulations using X_IGN, Y_IGN, and T_IGN keywords. The total number of ignitions is set by NUM_IGNITIONS.

```fortran
NUM_IGNITIONS = 2
X_IGN(1)      = 1000.0
Y_IGN(1)      = 1000.0
T_IGN(1)      = 0.0
X_IGN(2)      = 2000.0
Y_IGN(2)      = 2000.0
T_IGN(2)      = 7200.0

```

--------------------------------

### Ignition Point and Time Configuration

Source: https://elmfire.io/tutorials/tutorial_02.html

Define ignition locations (X, Y) and time of ignition (T) for fire spread simulations. These parameters are crucial for initializing the simulation.

```fortran
X_IGN(2)      = X2
Y_IGN(2)      = Y2
T_IGN(2)      = T2
/
```

--------------------------------

### Configure Point Source Ignitions for Fire Simulation

Source: https://elmfire.io/_sources/user_guide/io.rst.txt

Specify multiple point source ignitions with their coordinates and ignition times. The total number of ignitions is limited to 100.

```fortran
NUM_IGNITIONS = 2
X_IGN(1)      = 1000.0
Y_IGN(1)      = 1000.0
T_IGN(1)      = 0.0
X_IGN(2)      = 2000.0
Y_IGN(2)      = 2000.0
T_IGN(2)      = 7200.0
```

--------------------------------

### Configure Multiple Ignition Points

Source: https://elmfire.io/tutorials/tutorial_02.html

Define multiple ignition points for the fire simulation by specifying their coordinates and ignition times. This allows for modeling complex fire initiation scenarios.

```fortran
&SIMULATOR
NUM_IGNITIONS = 2
X_IGN(1)      = X1
Y_IGN(1)      = Y1
T_IGN(1)      = T1

```

--------------------------------

### Download Fire Perimeter Polygon

Source: https://elmfire.io/_sources/validation.rst.txt

Use the get_polygon.py script to download GIS data for a specific fire perimeter and timestamp. Specify the output directory with -o.

```bash
./get_polygon.py -o ./out --firename='ca-detwiler' --timestamp='20170717_094100'
```

--------------------------------

### Run ELMFIRE Simulation

Source: https://elmfire.io/tutorials/tutorial_01.html

Execute the main simulation script. This script handles input creation, ELMFIRE execution, and post-processing.

```bash
cd $ELMFIRE_BASE_DIR/tutorials/01-constant-wind
./01-run.sh

```

--------------------------------

### Configure Virtual Weather Stations in ELMFIRE

Source: https://elmfire.io/_sources/user_guide/io.rst.txt

Set the number of virtual stations and their coordinates to log detailed weather and fuel data. Each station generates a separate CSV file.

```fortran
NUM_VIRTUAL_STATIONS = 2
VIRTUAL_STATION_X(1) = 12345.0
VIRTUAL_STATION_Y(1) = 67890.0
VIRTUAL_STATION_X(2) = 98765.0
VIRTUAL_STATION_Y(2) = 43210.0
```

--------------------------------

### ELMFIRE Namelist Inputs Configuration

Source: https://elmfire.io/_sources/user_guide/io.rst.txt

Configuration for fuels, weather, and topography using the &INPUTS namelist group. Specifies directories and filenames for various raster inputs.

```fortran
&INPUTS
FUELS_AND_TOPOGRAPHY_DIRECTORY = './inputs'
ASP_FILENAME                   = 'asp'
CBD_FILENAME                   = 'cbd'
CBH_FILENAME                   = 'cbh'
CC_FILENAME                    = 'cc'
CH_FILENAME                    = 'ch'
DEM_FILENAME                   = 'dem'
FBFM_FILENAME                  = 'fbfm40'
SLP_FILENAME                   = 'slp'
ADJ_FILENAME                   = 'adj'
PHI_FILENAME                   = 'phi'
DT_METEOROLOGY                 = 3600.0
WEATHER_DIRECTORY              = './inputs'
WS_FILENAME                    = 'ws'
WD_FILENAME                    = 'wd'
M1_FILENAME                    = 'm1'
M10_FILENAME                   = 'm10'
M100_FILENAME                  = 'm100'
LH_MOISTURE_CONTENT            = 30.0
LW_MOISTURE_CONTENT            = 60.0
/

```

--------------------------------

### ELMFIRE &SPOTTING Configuration with Stochastic Spotting

Source: https://elmfire.io/user_guide/spotting.html

This configuration enables stochastic spotting and defines the minimum and maximum values for the eight stochastic spotting parameters, along with other related settings. Use this to control the range of random values generated for spotting behavior during a fire simulation.

```fortran
&SPOTTING
ENABLE_SPOTTING                          = .TRUE.
STOCHASTIC_SPOTTING                      = .TRUE.
CROWN_FIRE_SPOTTING_PERCENT_MIN          = 0.2
CROWN_FIRE_SPOTTING_PERCENT_MAX          = 0.8
ENABLE_SURFACE_FIRE_SPOTTING             = .TRUE.
GLOBAL_SURFACE_FIRE_SPOTTING_PERCENT_MIN = 0.2
GLOBAL_SURFACE_FIRE_SPOTTING_PERCENT_MAX = 0.8
CRITICAL_SPOTTING_FIRELINE_INTENSITY     = 2000.0
SPOTTING_DISTRIBUTION_TYPE               = 'LOGNORMAL'
MEAN_SPOTTING_DIST_MIN                   = 5.0
MEAN_SPOTTING_DIST_MAX                   = 10.0
NORMALIZED_SPOTTING_DIST_VARIANCE_MIN    = 250.0
NORMALIZED_SPOTTING_DIST_VARIANCE_MAX    = 600.0
SPOT_WS_EXP_LO                           = 0.4
SPOT_WS_EXP_HI                           = 0.7
SPOT_FLIN_EXP_LO                         = 0.2
SPOT_FLIN_EXP_HI                         = 0.4
NEMBERS_MIN                              = 1
NEMBERS_MAX_LO                           = 1
NEMBERS_MAX_HI                           = 1
PIGN_MIN                                 = 100.0
PIGN_MAX                                 = 100.0
/

```
Tokens:
Raw