Explaining building damage from wildfires in California
Data files
Jun 23, 2026 version files 387.34 MB
-
01_data_prep.R
10.93 KB
-
02_statistical_analysis.R
9.34 KB
-
03_plots.R
5.61 KB
-
CalDins_upd_extractions_subset_03.csv
37.09 MB
-
Causal_Forest.ipynb
2.66 MB
-
CBFR.R
15.35 KB
-
PredDamage_Prob_EnvExposureM_V02.tif
347.51 MB
-
RandomForest_SHAP.py
39.72 KB
-
README.md
4.63 KB
Abstract
Wildfires continue to devastate California's wildland-urban interface (WUI), where buildings intersect flammable landscapes. We present a physically interpretable, data-driven framework to elucidate causal interactions, model, and predict wildfire-induced building damage across California. Using over 100,000 damage inspection records (2013-2024), we identify the key environmental, structural, and exposure factors driving wildfire impacts on the built environment. Using Random Forest classifiers, building damage is modeled from static environmental variables (topography, vegetation, human footprint), dynamic weather inputs, and a Composite Building Flammability Rating (CBFR). Three model configurations were tested: (1) a comprehensive model integrating all variables, (2) an enviro-weather hybrid excluding CBFR, and (3) an environmental exposure model excluding both weather and CBFR. Applying a strict 200m spatial dead-zone constraint to eliminate local autocorrelation, the comprehensive model achieved 88% (±0.4%) accuracy, dropping to 82.9% (±0.6%) without CBFR and to 74.5% (±0.5%) without both weather and CBFR. Spatial grid-based cross-validation demonstrated a diverse accuracy of 68.0% (±17%), 66.0% (±16%), and 62.0% (±13%), respectively. Building flammability, dew point temperature, and near-surface wind vector were the most important predictors of damage. Causal analysis revealed spatially heterogeneous Conditional Average Treatment Effects, suggesting mitigation strategies should target specific environmental and anthropogenic gradients. We developed a 100-meter-resolution Wildfire Building Damage Risk Index (WBDRI) to highlight high-risk damage zones. Findings emphasize that wildfire impacts in the WUI result from a confluence of structural vulnerability, atmospheric dryness, and fuel exposure, offering scalable tools for risk forecasting, defensible space planning, and climate-resilient infrastructure development.
Dataset DOI: 10.5061/dryad.r2280gbrw
Description of the data and file structure
This dataset provides spatially explicit wildfire building-damage risk layers, Wildfire Building Damage Risk (WBDR), for California, along with the full analysis pipeline, from data preparation through statistical analysis, causal modeling, machine learning, and visualization, to support reproducibility and further exploration.
Files and variables
Data File: PredDamage_Prob_EnvExposureM_V02.tif
Description: This GeoTIFF raster layer provides spatially explicit wildfire building damage probabilities at 100-meter resolution for California, derived from an environmental exposure model. The layer represents the likelihood of wildfire-induced building damage based on environmental factors (weather, terrain, fuel characteristics, proximity to fire-prone landscapes) and exposure variables, excluding building-specific structural attributes. Probability values range from 0 (lowest risk) to 1 (highest risk), with values >0.55 (3rd quintile) indicating zones of comparatively elevated damage potential. This layer serves as an independent environmental risk assessment and can be integrated with Wildland-Urban Interface (WUI) boundaries to identify high-priority mitigation zones.
Spatial Coverage: California, USA
Temporal Coverage: Model calibration period 2013-2024
Spatial Resolution: 100 meters
Data Type: Continuous probability values (0-1 scale)
Coordinate Reference System: EPSG:4326
File Format: GeoTIFF (.tif)
NoData Value: NaN
Related Files: This layer can be combined with WUI-RS boundaries (Li et al., 2022) to generate the Wildfire Building Damage Potential WUI (WBDP-WUI) composite metric. https://datadryad.org/dataset/doi:10.7280/D1B98J
- CalDins_upd_extractions_subset_03.csv — Analysis-ready dataset uploaded directly to this repository. This file was derived from multiple open-source data sources (LANDFIRE, NLCD, CAL FIRE DINS postfire records, DAYMET climate data, and building footprint data) as detailed in the corresponding manuscript and in
01_data_prep.R. All source data are publicly available and are cited in the manuscript. - State- and county-level shapefiles — Not included in this repository. These are publicly available from the U.S. Census Bureau TIGER/Line database and can be downloaded directly from:
https://www2.census.gov/geo/tiger/TIGER2024/COUNTY/tl_2024_us_county.zip
Code files
The following scripts reproduce the full workflow, including data preparation, statistical analysis, machine-learning modeling, causal inference, and visualization:
- 01_data_prep.R — R script for data cleaning, feature engineering, and preparation of the CAL FIRE building damage inspection records and environmental/weather covariates. Requires
CBFR.Ras a dependency (sourced internally). - CBFR.R — R script that computes the Composite Building Flammability Rating (CBFR); sourced automatically by
01_data_prep.R. - 02_statistical_analysis.R — R script for statistical modeling and analysis of the prepared data, including Kruskal-Wallis tests, Dunn's post-hoc tests, correlation analysis, and PCA.
- 03_plots.R — R script for generating all figures and visualizations from the analysis outputs.
- RandomForest_SHAP.py — Python script implementing the Random Forest damage classifier (three configurations: comprehensive, enviro-weather hybrid, and environmental exposure) and SHAP-based feature importance analysis.
- Causal_Forest.ipynb — Jupyter Notebook implementing Causal Forest (CausalForestDML) modeling, including confounder selection and Average/Conditional Average Treatment Effect (ATE/CATE) estimation.
Reproducing the Analysis
To reproduce the full workflow:
- Download this repository and the county-level shapefile from the Census link above.
- Place the shapefile in the directory referenced in 01_data_prep.R
- The analysis-ready dataset (CalDins_upd_extractions_subset_03.csv) is provided directly in this repository, 02_statistical_analysis.R, 03_plots.R, RandomForest_SHAP.py, and Causal_Forest.ipynb can be run directly using this file without needing to re-run 01_data_prep.R.
- To re-run the full data preparation pipeline from raw sources, follow the instructions and source links documented in 01_data_prep.R.
