Cell2Fire

Runs the Cell2Fire C++ wildfire spread simulator with validated inputs, unit conversions, and diagnostic recovery.

155|6|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation --skill cell2fire-lzwei196
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Cell2Fire
Source: https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation/tree/main/models/Cell2Fire
Command: npx skills add https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation --skill cell2fire-lzwei196

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, pandas, pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? Running the Cell2Fire W wildfire simulator correctly requires operational expertise scattered across source code and docs: preparing co-registered landscape rasters, converting weather forcing into the exact units and conventions the model expects, selecting the right fire-behavior model and fuel lookup table, and diagnosing silent failures such as wind speed in m/s instead of km/h. This Skill packages that expertise so an agent can run the real C++ binary reliably instead of substituting approximations. ## Core Features & Use Cases - End-to-end simulation pipeline: Four validated tools cover landscape preparation, weather conversion to Weather.csv, fuel lookup table generation (Scott&Burgan, Canadian FBP, Kitral, Portugal), execution of the Cell2Fire binary, and parsing of outputs into burn probability maps and summary CSVs. - Unit and convention safety: Explicit conversion tables and 18 diagnostic triplets catch critical traps like wind direction convention errors, RH as fraction instead of percent, and raster dimension mismatches that cause segfaults. - Validation against cited benchmarks: Fire-scar outputs are graded against literature-derived CSI and burn-probability skill thresholds rather than intuition. - Use Case: Simulate the Vilopriu 2013 fire with the Scott&Burgan model over a 20m landscape grid, run a Monte Carlo ensemble, and compare the final burn scar against the observed perimeter using CSI. ## Quick Start Run python preflight_check.py in this directory, then ask the agent to simulate wildfire spread over your instance folder with the Scott&Burgan model and parse the resulting burn probability map.

Frequently Asked Questions about Cell2Fire

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a Cell2Fire wildfire simulation?

Compile the Cell2Fire binary, prepare an instance folder with fuel, elevation, slope, and aspect rasters plus Weather.csv, then run the binary with --input-instance-folder, --output-folder, --sim, and --nsims flags. The run_cell2fire tool wraps this execution with preflight checks.

What weather data format does Cell2Fire require?

Cell2Fire expects hourly Weather.csv rows with wind speed in km/h, wind direction in meteorological FROM convention, and for the FBP model temperature in Celsius, RH in percent, precipitation in mm, plus externally computed FWI System indices (FFMC, DMC, DC, ISI, BUI, FWI).

Which fire behavior models does Cell2Fire support?

Cell2Fire W supports four models selected by the --sim flag: Scott&Burgan (S) with 40 NFDRS fuel models, Canadian FBP (C) with 18 fuel types, Kitral (K) for Chilean vegetation, and an experimental Portugal model (P).

Why does my Cell2Fire fire barely spread or spread in the wrong direction?

The most common cause is wind speed supplied in m/s instead of km/h, making ROS about 3.6 times too low, or wind direction in mathematical TO convention instead of meteorological FROM, which reverses spread by 180 degrees. Check diagnostics/triplets.yaml for the matching remedy.

Why does Cell2Fire segfault at simulation start?

A segfault at startup is typically caused by raster dimension mismatch: all ASC files must share identical ncols, nrows, cellsize, and corner coordinates. Verify the raster headers match exactly before rerunning.

Can Cell2Fire compute Canadian FWI indices itself?

No. Cell2Fire does not compute FFMC, DMC, DC, ISI, BUI, or FWI; these must be derived externally using standard CFFDRS equations and supplied as columns in the FBP Weather.csv file.