Results¶
The results directory contains numerous NetCDF and GeoJSON files, each of which display some aspect of the runout of a given simulation. Within results, files are either in the top-level directory or within subdirectories.
Top-level files¶
The following standalone files exist within results.
summary.csv: This is a .csv file containing information about each run, as well as the total volume of water and sediment initiated and the inundation area (square kilometers).
runparams.csv: This is a .csv file containing information about each run such as rainfall intensity.
Results in subdirectories¶
run_nc¶
The run_nc directory contains a NetCDF file for each individual run, each having the following layers:
h_max: the maximum height of debris flow in each computational grid cell during any part of the simulation.
hss_max: the maximum height * speed^2 of debris-flow material in each computational grid cell during any part of the simulation.
arrival_time: the time (in seconds) that debris-flow material first reached a computational grid cell.
runs¶
The runs directory contains many of the unprocessed files that result from running all of the simulations, broken up into an individual folder for each run, and those folders have additional subdirectories for each individual region’s simulations. Each of the run directories contain the following files/directories (where X is the run number):
basin_info-run_X.csv: file containing information about each basin in the fire area, such as probability of basins leading to runout and the area of each basin.
basin_info-run_X.geojson: file containing much of the same information as the .csv file, now including the geometry of the basin.
run_params.yml: file containing important parameters for the run as a whole, such as rainfall intensity and “flowiness”.
In addition to all of the files for the run itself, each individual region simulated has a folder, with numerous files, such as a basin info file for basins within the region bounds, and numerous files created by dclaw (most end with .data).
synthesis¶
The synthesis directory contains files that represent the debris-flow simulation index across the affected area, as well as NetCDF files that contain other information such as maximum height of debris-flow material across all runs associated with an individual \(I_{15}\). For each rainfall intensity specified in the config file, the following files are generated (where X is the \(I_{15}\) value):
I15_X-simulation_index.geojson: file containing the debris-flow simulation index across the simulated area. Find more information about how we define hazard index here.
I15_X-results.nc: this NetCDF contains the following layers:
median_max_hss: the median of the maximum value of height * speed^2 across the area of the simulation
median_max_h: the median of the maximum value of the height across the area of the simulation
simulation_index: the debris-flow simulation index across the simulated area (see here for more information about this variable).
expected_max_hss: the mean of the maximum value of height * speed^2 across the area of the simulation
expected_max_h:the mean of the maximum value of the height across the area of the simulation
hss_gt005_index: the fraction of simulations with height * speed^2 greater than 0.5 m^3/s^2.
hss_gt050_index: the fraction of simulations with height * speed^2 greater than 5 m^3/s^2.
hss_gt500_index: the fraction of simulations with height * speed^2 greater than 50 m^3/s^2.
exposure¶
The exposure directory contains files that are generated by the exposure analysis. This analysis considers the length of road, the number of buildings, and the number of crossings impacted by active basins and inundated area. A crossing is defined as the point intersection of a road and a stream.
Filenames and column names are based on the rainfall intensities specified in the config file. X is the \(I_{15}\) value.
Buildings, crossings, and road segments located within an active basin are given a debris-flow simulation index (DFSI) value of 1.05, larger than the largest possible value due to inundation.
buildings_exposure.csv: A csv file summarizing the exposure of buildings containing one row for every building and the following columns:
region: The region containing the building
centroid_x: The x-coordinate of the building centroid.
centroid_x: The y-coordinate of the building centroid.
I15_X_DFSI: The DFSI value of the model grid cell containing the building centroid for \(I_{15}\)=X.
crossings_exposure.csv: A csv file summarizing the exposure of crossings containing one row for each crossing and the following columns:
region: The region containing the crossing
centroid_x: The x-coordinate of the crossing centroid.
centroid_x: The y-coordinate of the crossing centroid.
I15_X_DFSI: The DFSI value of the model grid cell containing the building centroid for \(I_{15}\)=X.
roads_exposure.csv: A csv file summarizing the exposure of roads. The analysis of roads is slightly different than that of crossings or buildings because road segments are lines rather than points. For each \(I_{15}\) the road polylines are broken into segments that intersect each DFSI values. The csv has one row for each road segment created and the following columns:
I15: The \(I_{15}\)
region: The region containing the road segment
DFSI: The DFSI value of the road segment at the considered \(I_{15}\).
length: The length of the road segment in meters.
centroid_x: The x-coordinate of the road segment centroid.
centroid_x: The y-coordinate of the road segment centroid.
summary_exposure.csv: A csv summarizing exposure by region and \(I_{15}\). It will have a unique row for each \(I_{15}\)-region-DFSI value combination (including the a ‘fire-wide’ region that sums across all region). It will also have a row for each \(I_{15}\) and region summarizing the buildings, roads, and crossings located in active basins. The columns are as follows:
I15: The \(I_{15}\)
region: The region
DFSI_thresh: The minimum DFSI value considered for this row.
total_road_length: The sum of all road length segments in this region for this \(I_{15}\) that have a DFSI greater than DFSI_thresh. This summation does not include the road length within active basins if inundated=True.
total_number_crossings: The total number of crossings in this region for this \(I_{15}\) that have a DFSI greater than DFSI_thresh. This summation does not include crossings within active basins if inundated=True.
total_number_buildings: The total number of buildings in this region for this \(I_{15}\) that have a DFSI greater than DFSI_thresh. This summation does not include buildings within active basins if inundated=True.
inundated: A flag indicating whether this row considers the inundated area only (inundated=True) or the active basins only (inundated = False).
buildings_exposure.geojson: A geojson file that contains all columns in buildings_exposure.csv* except for the centroid coordinates. The geometry is the provided building geometry polygon.
crossings_exposure.geojson: A geojson file that contains all columns in crossings_exposure.csv* except for the centroid coordinates. The geometry is the calculated crossing locations (point intersections of provided roads and streams).
roads_exposure-I15_X.geojson: A geojson file specific to one \(I_{15}\) that documents how road polylines were split up based on DFSI value. Column names are the same as in roads_exposure.csv except for the centroid coordinates.