Outputs
Clicking ‘Get output’s runs the FCCS and Consume calculators and displays output links and charts beneath the editor tables (you may have to scroll).
Tables
Output CSV files
The first files listed in the Downloads sections are each tool’s main output files (saved as comma-separated values (CSV) files).
- FCCS Outputs
The FCCS calculator generates estimated surface fire metrics (rate of spread, flame length, and reaction intensity), FCCS potentials (surface fire behavior (SFP), crown fire (CFP), and available fuel (AFP)) and subpotentials, and loadings by stratum needed by Consume for its estimates of consumption, heat release, and emissions. Click the ‘FCCS Output Results’ link to download the FCCS output file (fccs.csv). The table has 100 columns and as many rows (other than the header) as fuelbeds processed. See FCCS Outputs table for full list of fields with definitions. For more in-depth explanations of these values refer to the 2013 GTR Fuel Characteristic Classification System Version 3.0: Technical Documentation.
- Consume Outputs
Consume generates estimated fuel consumption (broken out both by stratum and by fire phase), emissions for methane, carbon monoxide, carbon dioxide, ammonia, non-methane hydrocarbons and organic compounds, nitrogen oxides, sulfur dioxide, and particulate matter (broken out both by stratum and by fire phase), and heat release (broken out by fire phase) based on supplied fuel characteristics and environmental conditions. Click the ‘Consume Output’ link to download Consume’s core outputs file (consume-output.csv). This table has 195 columns with one row per fuelbed processed. See Consume Outputs table for detailed definitions for each field. See also the ‘Interpreting Reports and Graphs’ section of the Consume 3.0 Users Guide.
Generated Input Files
The second set of download file sections are the csv files needed to run each tool at command line.
- FCCS Moisture CSV
Single line input file taken as optional argument when running FCCS from command line.
java –jar fuelbed.jar SampleFB\*.xml –p moisture_file=fccs-moisture.csv
Data dictionary for fccs-moisture.csv
| Field
| Definition (units)
| Sample data
|
| oneHourFM |
Fuel moisture content of 1-hr fuels (%) |
6 |
| tenHourFM |
Fuel moisture content of 10-hr fuels (%) |
7 |
| hundredHourFM |
Fuel moisture content of 100-hr fuels (%) |
8 |
| liveNonWoodyFM |
Live fuel moisture content of herbaceous fuels (%) |
60 |
| liveShrubFM |
Live fuel moisture content of shrubs (%) |
90 |
| crownFM |
Life fuel moiustre content of tree crowns (%) |
90 |
- Consume Input CSV
Environmental input file taken as an argument when running Consume from command line, containing as many rows as fuelbeds.
python consume_batch.py activity consume-input-file.csv -f consume_loadings.csv
Data dictionary for consume-input-file.csv with default values as examples.
| Field
| Definition (units)
| Sample data
|
| fuelbeds |
Fuelbed number (one per row) |
220u1 |
| area |
Area (acres) |
1 |
| fm_duff |
Fuel moisture content of duff (%) |
40 |
| fm_1000hr |
Fuel moisture content of 1000-hr fuels (%) |
15 |
| can_con_pct |
Percent of canopy stratum blackened by fire (%) |
0 |
| shrub_black_pct |
Percent of shrub stratum blackened by fire (%) |
50 |
| pile_black_pct |
Percent consumption of piles (%) |
90 |
| units |
Specified output units (tons or tons per acre) |
tons |
| ecoregion |
Boreal, Southern, or Western |
western |
| fm_litter |
Fuel moisture content of litter (%) |
10 |
| season |
Winter, spring, summer, or fall |
fall |
| duff_pct_available |
% duff available for consumption, 0-100% |
55 |
| sound_cwd_pct_available |
% sound coarse woody debris available for consumption, 0-100% |
55 |
| rotten_cwd_pct_available |
% rotten coarse woody debris available for consumption, 0-100% |
70 |
| Activity fuels only: |
| slope |
Slope gradient (%) |
0 |
| windspeed |
Windspeed (mph) |
4 |
| days_since_rain |
Number of days since significant rainfall (> ¼ inch) |
7 |
| length_of_ignition |
Time to ignite burn unit (min.) |
30 |
| fm_type |
Type of fuel moisture (MEAS-Th or NFDRS-Th) |
MEAS-Th |
| fm_10hr |
Fuel moisture of 10-hr wood |
10 |
- Consume Loadings (always English units)
FCCS loadings by fuelbed, formatted for input to Consume at command line (consume-loadings.csv).
python consume_batch.py natural consume-input-file.csv -f consume-loadings.csv
The FCCS/Consume loadings table, generated by the FCCS calculator, has 51 columns with one row per fuelbed. See the Consume Inputs: Loadings data dictionary for field definitions (essentially a repackaging of fields from fccs.csv as needed by Consume).
Reports
FCCS Reports (PDF)
- FCCS Input Variables
FCCS Environment Variables Report. This PDF provides a formatted table with the FCCS Environmental Variables specified for the given run. It consists of a single row, applying to all fuelbeds included in the run. It includes the values from the FCCS Moisture CSV (fccs-moisture.csv) along with percent slope and windspeed.
| Report Field
| CSV Field
| Definition
| English units
| Metric units
|
| slope |
|
Percent slope |
% |
% |
| wind |
|
Midflame windspeed |
mph |
km/hr |
| fm_herb |
liveNonWoodyFM |
Live fuel moisture content of herbaceous fuels |
% |
% |
| fm_shrub |
liveShrubFM |
Live fuel moisture content of shrubs |
% |
% |
| fm_crown |
crownFM |
Life fuel moisture content of tree crowns |
% |
% |
| fm_hr1 |
oneHourFM |
Fuel moisture content of 1-hr fuels |
% |
% |
| fm_hr10 |
tenHourFM |
Fuel moisture content of 10-hr fuels |
% |
% |
| fm_hr100 |
hundredHourFM |
Fuel moisture content of 100-hr fuels |
% |
% |
- Potentials
FCCS 4.0 Potentials Report. This PDF provides a formatted table with the FCCS Potential values, given in the FCCS outputs file (fccs.csv) for each fuelbed included in the run.
| Report Field
| CSV Field
| Definition
| English units
| Metric units
|
| FB# |
Fuelbed_number |
Fuelbed number |
|
|
| FCC_Code |
FCC_Code |
3-digit code comprised of the dimensionless potentials (0=min, 9=max) for surface fire behavior (SFP), crown fire (CFP), and available fuel (AFP) |
|
|
| SFP |
Surface_fire_potential |
Surface fire behavior summary potential (SFP), calculated as the maximum of the flame length potential (FP) and reaction potential (RP), scaled to values of 0 to 9 (dimensionless) |
|
|
| Reaction |
Reaction_potential |
A subpotential of SFP, reaction potential (RP) represents the reaction intensity (energy release per unit area per unit time) under dry fuel conditions (0-9 index). |
|
|
| Spread |
Spread_potential |
A subpotential of SFP, spread potential (SP) is proportional to the R (distance per unit time at benchmark environmental conditions) in surface fuels (0-9 index). |
|
|
| Flame |
Flamelength_potential |
A subpotential of SFP, flame length potential (FP) is the predicted flame length (in feet, at benchmark environmental conditions) proportional to fireline intensity or FL (0-9 index). |
|
|
| CFP |
Crown_fire_potential |
Crown fire behavior summary potential (CFP) (0-9 index) |
|
|
| Initiation |
Crown_initiation_potential |
A subpotential of CFP, crown fire initiation (IC) represents the likelihood that a surface fire will propagate into a crown fire. |
|
|
| Transmissivity |
Crown-crown_trans_potential |
A subpotential of CFP, crown-to-crown transmissivity (TC) represents the potential for fire to carry through a forest canopy (0-9 index). |
|
|
| CSpread |
Crownfire_spread_potential |
A subpotential of CFP, crown fire rate of spread (RC) is a relative index of crown fire spreading potential (0-9 index). |
|
|
| AFP |
Available_fuel_potential |
Available fuel summary potential (AFP), an estimate of the mass of fuel present within the outside shell of layers of canopy, surface, and ground fuel elements that are potentially combustible under dry conditions in the flaming, smoldering, and residual smoldering phases of combustion (0-9 index). |
|
|
| AFFlame |
Flame_available_potential |
A subpotential of AFP, flame available fuel (FA) is the sum of mass within ½ in of the surface of the fuel element available for the flaming phase of combustion (10 tons/ac - can exceed 9 to represent actual available loading values). FA is the sum of flame-reactive surface available fuel (the mass of fuel consumed in the flaming front of a spreading surface fire), flame-available postreactive surface fuels (the remainder of flame-available surface fuel after the passage of the flaming front), and flame-available canopy fuel (the mass of tree canopy and fine twigs). |
10 tons/ac |
2.24 Mg/ha? |
| AFSmolder |
Smolder_available_potential |
A subpotential of AFP, smoldering available fuel (SA) is the sum of mass between ½ and 2 in of a fuel surface (10 tons/ac - can exceed 9 to represent actual available loading values). |
10 tons/ac |
|
| AFResidual |
Residual_smolder_potential |
A subpotential of AFP, residual available fuel (RA) is the sum of mass between 2 and 4 in of a fuel surface (10 tons/ac - can exceed 9 to represent actual available loading values). |
10 tons/ac |
|
- Surface Fire Behavior
FCCS Surface Fire Behavior Report. This PDF provides a formatted table with FCCS’s estimated surface fire behavior metrics (given in the FCCS outputs file (fccs.csv) fields starting with the prefix Custom_) for each fuelbed included in the run for the specified environmental scenario (given in the FCCS Input Variables report).
| Report Field
| CSV Field
| Definition
| English units
| Metric units
|
| FB# |
Fuelbed_number |
Fuelbed number |
|
|
| ROS |
Custom_ROS |
Predicted rate of spread under user-defined environmental scenario |
ft |
m |
| FL |
Custom_FL |
Predicted flame length under user-defined environmental scenario |
ft |
m |
| RI Total |
Custom_RI |
Predicted surface reaction intensity under user-defined environmental scenario |
Btu/ft2/min |
KJ/m2 |
| RI shrub |
Custom_RI_Shrub |
Shrub component reaction intensity under user-defined environmental scenario |
Btu/ft2/min |
KJ/m2 |
| RI herb |
Custom_RI_Herb |
Herb component reaction intensity under user-defined environmental scenario |
Btu/ft2/min |
KJ/m2 |
| RI wood |
Custom_RI_Wood |
Downed wood component reaction intensity under user-defined environmental scenario |
Btu/ft2/min |
KJ/m2 |
| RI llm |
Custom_RI_LLM |
LLM component reaction intensity under user-defined environmental scenario |
Btu/ft2/min |
KJ/m2 |
| XWalk13 |
Custom_Crosswalk13 |
Crosswalk to one of 13 original fire behavior prediction system (FBPS) fuel models defined by Anderson (1982) based on vegetation type, predicted rate of spread (ROS) and flame length (FL) under user-defined environmental scenario |
|
|
| %ROS13 |
Custom_ROS%13 |
Percent difference of given fuelbed's Custom_ROS from the assigned Custom_Crosswalk13 fuel model's predicted rate of spread (under the same user-defined environmental scenario) |
% |
% |
| FL%13 |
Custom_FL%13 |
Percent difference of given fuelbed's Custom_FL from the assigned Custom_Crosswalk13 fuel model's predicted flame length (under the same user-defined environmental scenario) |
% |
% |
| Xwalk40 |
Custom_Crosswalk40 |
Crosswalk to one of the 40 standard fire behavior fuel models defined by Scott and Burgan (2005) based on assigned Crosswalk13, predicted rate of spread (ROS) and flame length (FL) under user-defined environmental scenario |
|
|
| %ROS40 |
Custom_ROS%40 |
Percent difference of given fuelbed's Custom_ROS from the assigned Custom_Crosswalk40 fuel model's predicted rate of spread (under the same user-defined environmental scenario) |
% |
% |
| %FL40 |
Custom_FL%40 |
Percent difference of given fuelbed's Custom_FL from the assigned Custom_Crosswalk40 fuel model's predicted flame length (under the same user-defined environmental scenario) |
% |
% |
- Fuel Loadings
FCCS Total Aboveground Biomass Report. This PDF provides a formatted table of biomass per stratum, given in more detail in the FCCS outputs file (fccs.csv).
| Report Field
| CSV Field
| Definition
| English units
| Metric units
|
| FB# |
Fuelbed_number |
Fuelbed number |
|
|
| Total fuelbed |
Total_aboveground_biomass |
Total aboveground biomass (tree and shrub crowns excluded from this sum) |
tons/ac |
Mg/ha |
| Canopy |
Sum of Tree, Snag, and LadderFuel loadings |
Canopy loading |
tons/ac |
Mg/ha |
| Shrub |
Sum of Primary and Secondary Shrub loadings |
Shrub loading |
tons/ac |
Mg/ha |
| Herb |
Sum of Primary and Secondary Herb loadings |
Herb loading |
tons/ac |
Mg/ha |
| Wood |
Sum of Wood, Stumps, and Pile loadings |
Wood loading |
tons/ac |
Mg/ha |
| LLM |
Sum of Litter, Lichen, and Moss loadings |
Litter-lichen-moss loading |
tons/ac |
Mg/ha |
| Ground fuels |
Sum of Duff, Basal Accumulation, and Squirrel Midden loadings |
Ground fuel loading |
tons/ac |
Mg/ha |
- Carbon
FCCS Carbon Report. This PDF provides a formatted table of estimated carbon per stratum (currently assumed to be 50% of estimated biomass). These values are not given explicitly in the fccs.csv output file.
| Report Field
| Definition
| English units
| Metric units
|
| FB# |
Fuelbed number |
|
|
| Total fuelbed |
Total aboveground carbon (tree and shrub crowns excluded from this sum) |
tons/ac |
Mg/ha |
| Canopy |
Canopy carbon |
tons/ac |
Mg/ha |
| Shrub |
Shrub carbon |
tons/ac |
Mg/ha |
| Herb |
Herb carbon |
tons/ac |
Mg/ha |
| Wood |
Wood carbon |
tons/ac |
Mg/ha |
| LLM |
Litter-lichen-moss carbon |
tons/ac |
Mg/ha |
| Ground fuels |
Ground fuel carbon |
tons/ac |
Mg/ha |
Consume Reports (PDF)
- Consume Input Variables
Consume Environment Variables Report. This PDF provides a formatted table with the Consume environmental variables specified for the given run. It consists of a single row, applying to all fuelbeds included in the run. It includes the values from the Consume Input CSV (consume-input-file.csv).
| Report Field
| CSV Field
| Definition
|
| fuel_type |
fm_duff |
Fuel moisture content of duff (%) |
| fm_duff |
fm_duff |
Fuel moisture content of duff (%) |
| fm_1000hr |
fm_1000hr |
Fuel moisture content of 1000-hr fuels (%) |
| can_con_pct |
can_con_pct |
Percent of canopy stratum blackened by fire (%) |
| shrub_black_pct |
shrub_black_pct |
Percent of shrub stratum blackened by fire (%) |
| pile_black_pct |
pile_black_pct |
Percent consumption of piles (%) |
| ecoregion |
ecoregion |
Boreal, Southern, or Western |
| fm_litter |
fm_litter |
Fuel moisture content of litter (%) |
| season |
season |
Winter, spring, summer, or fall |
| duff_pct_available |
duff_pct_available |
% duff available for consumption, 0-100% |
| sound_cwd_pct_available |
sound_cwd_pct_available |
% sound coarse woody debris available for consumption, 0-100% |
| rotten_cwd_pct_available |
rotten_cwd_pct_available |
% rotten coarse woody debris available for consumption, 0-100% |
| days_since_rain |
days_since_rain |
Activity fuels only. Number of days since significant rainfall (> ¼ inch) |
| length_of_ignition |
length_of_ignition |
Activity fuels only. Time to ignite burn unit (min.) |
| fm_type |
fm_type |
Activity fuels only. Type of fuel moisture (MEAS-Th or NFDRS-Th) |
- Consumption by Stratum
Consume Consumption by Stratum Report. This PDF provides a formatted table with the consumption estimates by stratum calculated for the given run. It has one row per fuelbed and includes values from the Consume Output CSV (consume-output.csv).
| Report Field
| CSV Field
| Definition
| English units
| Metric units
|
| FB# |
fuelbeds |
Fuelbed number |
|
|
| Preburn Loading |
|
|
tons/ac |
Mg/ha |
| Total |
c_total |
Estimated amount of vegetative biomass consumed during the specified burn |
tons/ac |
Mg/ha |
| Canopy |
c_canopy |
Estimated canopy fuel consumption during the specified burn |
tons/ac |
Mg/ha |
| Shrub |
c_shrub |
Estimated shrub fuel consumption during the specified burn |
tons/ac |
Mg/ha |
| Herb |
c_herb |
Estimated herbaceous fuel consumption during the specified burn |
tons/ac |
Mg/ha |
| Wood |
c_wood |
Estimated woody fuel consumption during the specified burn |
tons/ac |
Mg/ha |
| LLM |
c_llm |
Estimated consumption of litter-lichen-moss during the specified burn |
tons/ac |
Mg/ha |
| Ground |
c_ground |
Estimated ground fuel consumption during the specified burn |
tons/ac |
Mg/ha |
- Emissions by Pollutant
Consume Emissions by Pollutant Report. This PDF provides a formatted table with the total emissions by pollutant estimated for the given run. It has one row per fuelbed and includes values from the Consume Output CSV (consume-output.csv).
| Report Field
| CSV Field
| Definition
| English units
| Metric units
|
| FB# |
fuelbeds |
Fuelbed number |
|
|
| CH4 |
ch4 |
Estimated methane emissions during the specified burn |
tons/ac |
Mg/ha |
| CO |
co |
Estimated carbon monoxide emissions during the specified burn |
tons/ac |
Mg/ha |
| CO2 |
co2 |
Estimated carbon dioxide emissions during the specified burn |
tons/ac |
Mg/ha |
| NH3 |
nh3 |
Estimated ammonia emissions during the specified burn |
tons/ac |
Mg/ha |
| NMOC |
nmoc |
Estimated emissions of non-methane organic compounds during the specified burn |
tons/ac |
Mg/ha |
| NOx |
nox |
Estimated emissions of nitrogen oxides (NO + NO2) during the specified burn |
tons/ac |
Mg/ha |
| SO2 |
so2 |
Estimated sulfur dioxide emissions during the specified burn |
tons/ac |
Mg/ha |
| PM10 |
pm10 |
Estimated PM10 (inhalable particles with diameters that are generally 10 micrometers and smaller) emissions during the specified burn |
tons/ac |
Mg/ha |
| PM25 |
pm25 |
Estimated PM2.5 (fine inhalable particles with diameters that are generally 2.5 micrometers and smaller) emissions during the specified burn |
tons/ac |
Mg/ha |
- Pollutant Emissions by Stratum
These PDFs provide a formatted tables with Consume’s estimated pollutant emissions generated by stratum for the given run. It has one row per fuelbed and includes values from the Consume Output CSV (consume-output.csv). Emissions by stratum (Total, Canopy, Shrub, Herb, Wood, LLM, and Ground) reports include:
- CH4 by Stratum
- CO by Stratum
- CO2 by Stratum
- NMOC by Stratum
- NOx by Stratum
- SO2 by Stratum
- PM10 by Stratum
- PM2.5 by Stratum
Charts
Interactive bar charts are generated for each run to aid in data visualization and comparison among fuelbeds. FCCS and Consume charts are organized into tabs.
FCCS
All the FCCS charts use the numbers given in the FCCS output file (fccs.csv) as their source.
- Surface Fire Behavior Charts
These charts depict estimated surface fire metrics under user-defined (custom) environmental conditions (given in the FCCS Inputs Report.
- Rate of Spread shows estimated fire spread rate for each fuelbed (ft/min, m/min)
- Flame Length shows estimated fuelbed flame lengths (ft, m)
- Reaction Intensity shows each fuelbed’s heat release rate per unit area of the flaming front, broken out by stratum (Btu/ft2/min,kW/m2)
- Summary of Potentials Chart
This chart shows each fuelbed’s 3 FCCS Potentials (dimensionless 0-9 indexes for surface fire behavior (SFP), crown fire (CFP), and available fuel (AFP)) under benchmark conditions (i.e., 0% slope, 4mph wind, dry D2L2 moisture profile).
- Aboveground Biomass by Stratum
This chart depicts each fuelbed’s estimated aboveground biomass per unit area in a stacked bar chart showing each stratum’s contribution (tons/ac, Mg/ha).
- Carbon by Stratum
This chart depicts each fuelbed’s estimated carbon mass/area (calculated as aboveground biomass*0.5) in a stacked bar chart showing each stratum’s contribution (tons/ac, Mg/ha).
Consume
All the Consume charts use the numbers given in the Consume output file (consume-output.csv) as their source.
- Consumption by Stratum
This chart depicts each fuelbed’s estimated biomass/area of fuel consumed by fire in a stacked bar chart showing each stratum’s contribution (tons/ac, Mg/ha).
- Pollutant Emissions by Stratum
These charts show each fuelbed’s estimated emissions for the given pollutant in a stacked bar chart showing each stratum’s contribution (lbs/ac, kg/ha).
- PM2.5 Emissions by Stratum
- CO Emissions by Stratum
- CO2 Emissions by Stratum
- NMOC Emissions by Stratum
- NOx Emissions by Stratum
- SO2 Emissions by Stratum
- PM10 Emissions by Stratum
- CH4 Emissions by Stratum
