FCCS Command Line Instructions
The Fuel and Fire Tools application contains the FCCS calculator and a command-line interface. You can run large sets of fuelbeds through the FCCS calculator from a command prompt by specifying a fuelbed directory.
- Open a command prompt. In Windows, you can type “cmd” in the search box of the Start menu, and a command prompt will open.
- Change directories to the FCCS_3 folder within the Fuel and Fire Tools folder. For example:
> cd c:\FuelFireTools\FCCS_3
- Launch the calculator to get basic usage instructions.
> java –jar fuelbed.jar
- To run the FCCS for all fuelbeds within a folder (named “SampleFB” in this example and located within c:\FuelFireTools\FCCS_3) using the benchmark environmental scenario, simply type:
> java –jar fuelbed.jar SampleFB\*.xml
- To run the FCCS for the same fuelbed folder under a specified moisture scenario, first edit the file fccs_moisture.csv (which is located in c:\FuelFireTools\FCCS_3). Then type:
> java –jar fuelbed.jar SampleFB\*.xml –p moisture_file=fccs_moisture.csv
- To convert the output file (fccs_summary.csv) to metric values, type:
> python.exe fccs_post_process.py fccs_summary.csv metric_all.csv metric_output.csv true
- For other commands, such as specifying an output filename and location or specifying wind or slope inputs, please refer basic usage instructions within the command prompt.
Input definitions
A sample FCCS moisture file is located within the FCCS_3 folder (c:\FuelFireTools\FCCS_3\fccs_moisture.csv).
| Variable | Definition (English, metric units) | Sample Unit |
| oneHourFM | Fuel moisture content of 1-hour time lag wood (0-1/4 inch diameter) | 6% |
| tenHourFM | Fuel moisture content of 10-hour time lag wood (1/4-1 inch diameter) | 8% |
| hundredHourFM | Fuel moisture content of 100-hour time lag wood (1-3 inch diameter) | 10% |
| liveNonWoodyFM | Live fuel moisture content of herbaceous fuels | 30% |
| liveShrubFM | Live fuel moisture content of shrubs | 60% |
| crownFM | Live fuel moisture content of tree crowns | 60% |
Output definitions
FCCS outputs will be found in the FCCS3 folder (e.g., c:\FuelFireTools\FCCS_3\fccs_summary.csv). Outputs are currently only in English units.
Table 1: FCCS batch output variables and definitions.
| Variable | Definition (English, metric units) | Sample output English units |
| Filename | Fuelbed filename | FB_0053_FCCS.xml |
| FB_ID | Fuelbed ID (alphanumeric) | 53 |
| FB_name | Fuelbed name | Pacific ponderosa pine forest |
| FCCS_Code | 3-digit code representing surface, crownfire, and available fuel summary potentials, respectively | 446 |
| SFP | Surface fire behavior summary potential (0-9 index) | 4.27 |
| Surface_Reaction | Reaction potential (0-9 index) | 3.61 |
| Surface_Spread | Spread potential (0-9 index) | 4.27 |
| Surface_Flamelength | Flame length potential (0-9 index) | 3.23 |
| CFP | Crown fire behavior summary potential (0-9 index) | 4.45 |
| Crown_initiation | Crown fire initiation potential (0-9 index) | 3.16 |
| Crown_Transmissivity | Crown to crown transmissivity potential (0-9 index) | 8.85 |
| Crown_spread | Crown fire spreading potential (0-9 index) | 4.26 |
| AFP | Available fuel summary potential (0-9 index) | 6.42 |
| Available_Flame | Flame available fuel potential (0-9 index) | 3.22 |
| Available_Smolder | Smolder available fuel potential (0-9 index) | 2.43 |
| Available_Residual | Residual smolder available fuel potential (0-9 index) | 0.76 |
| ROS | Rate of spread, benchmark environmental scenario (ft, m) | 4.55 |
| FL | Flame length, benchmark environmental scenario (ft, m) | 2.60 |
| RI | Surface reaction intensity, benchmark environmental scenario (BTU ft-2 m-1, KJ m-2) | 2041.21 |
| RI_shrub | Shrub component reaction intensity, benchmark environmental scenario (BTU ft-2 m-1, KJ m-2) | 0 |
| RI_herb | Herb component reaction intensity, benchmark environmental scenario (BTU ft-2 m-1, KJ m-2) | 351.78 |
| RI_wood | Downed wood component reaction intensity, benchmark environmental scenario (BTU ft-2 m-1, KJ m-2) | 504.60 |
| RI_LLM | LLM component reaction intensity, benchmark environmental scenario (BTU ft-2 m-1, KJ m-2) | 1184.82 |
| Xwalk13 | Crosswalk to 1 of 13 original fuel models under benchmark scenario | 9 |
| ROS%13 | Percent different ROS from crosswalk 13 fuel model, benchmark environmental scenario | 66.78 |
| FL%13 | Percent different Flame length from crosswalk 13 fuel model, benchmark environmental scenario | 104.01 |
| Xwalk40 | Crosswalk to 1 of 40 standard fuel models, benchmark environmental scenario | 188 |
| ROS%40 | Percent different ROS from crosswalk 40 fuel model, benchmark environmental scenario | 99.01 |
| FL%40 | Percent different FL from crosswalk 40 fuel model, benchmark environmental scenario | 86.68 |
| User_ROS | Rate of spread, user environmental scenario (ft, m) | 4.55 |
| User_FL | Flame length, user environmental scenario (ft, m) | 2.59 |
| User_RI | Surface reaction intensity, user environmental scenario (BTU ft-2 m-1, KJ m-2) | 2002.58 |
| User_RI_shrub | Shrub component reaction intensity, user environmental scenario (BTU ft-2 m-1, KJ m-2) | 0 |
| User_RI_herb | Herb component reaction intensity, user environmental scenario (BTU ft-2 m-1, KJ m-2) | 313.16 |
| User_RI_wood | Downed wood component reaction intensity, user environmental scenario (BTU ft-2 m-1, KJ m-2) | 504.60 |
| User_RI_LLM | LLM component reaction intensity, user environmental scenario (BTU ft-2 m-1, KJ m-2) | 1184.82 |
| User_xwalk13 | Crosswalk to 1 of 13 original fuel models under user environmental scenario | 9 |
| User_ROS%13 | Percent different ROS from crosswalk 13 fuel model, user environmental scenario | 66.78 |
| User_FL%13 | Percent different FL from crosswalk 13 fuel model, user environmental scenario | 103.63 |
| User_xwalk40 | Crosswalk to 1 of 40 standard fuel models, user environmental scenario | 188 |
| User_ROS%40 | Percent different ROS from crosswalk 40 fuel model, user environmental scenario | 99.01 |
| User_FL%40 | Percent different FL from crosswalk 40 fuel model, user environmental scenario | 86.36 |
| Tree_over_crown_load | Overstory tree crown load (tons ac-1, Mg ha-1) | 9.22 |
| Tree_mid_crown_load | Midstory tree crown load (tons ac-1, Mg ha-1) | |
| Tree_under_crown_load | Understory tree crown load (tons ac-1, Mg ha-1) | 0.295 |
| Tree_aboveground_load | Aboveground biomass of trees (tons ac-1, Mg ha-1) | 56.00 |
| Snag_class1_foliage_load | Class 1 snag with foliage crown load (tons ac-1, Mg ha-1) | 0.12 |
| Snag_class1_wood_load | Class 1 snag with foliage wood load (tons ac-1, Mg ha-1) | 4.64 |
| Snag_class1_other_load | Class 1 snag other wood load (tons ac-1, Mg ha-1) | |
| Snag_class2_load | Class 2 snag wood load (tons ac-1, Mg ha-1) | 1.96 |
| Snag_class3_load | Class 3 snag wood load (tons ac-1, Mg ha-1) | 0.43 |
| Ladderfuels_load | Ladder fuel load (tons ac-1, Mg ha-1) | 3 |
| Shrub_primary_load | Primary shrub load (tons ac-1, Mg ha-1) | |
| Shrub_primary_crown_load | Primary shrub crown load (tons ac-1, Mg ha-1) | |
| Shrub_secondary_load | Secondary shrub load (tons ac-1, Mg ha-1) | |
| Shrub_secondary_crown_load | Secondary shrub crown load (tons ac-1, Mg ha-1) | |
| Shrub_needleDrape_load | Shrub needle drape load (tons ac-1, Mg ha-1) | |
| Herb_primary_load | Primary herbaceous load (tons ac-1, Mg ha-1) | 0.05 |
| Herb_secondary_load | Secondary herbaceous load (tons ac-1, Mg ha-1) | 0.01 |
| Woody_sound_1hr_load | Sound 1hr wood load (tons ac-1, Mg ha-1) | 0.1 |
| Woody_sound_10hr_load | Sound 10hr wood load (tons ac-1, Mg ha-1) | 1.5 |
| Woody_sound_100hr_load | Sound 100hr wood load (tons ac-1, Mg ha-1) | 1.5 |
| Woody_sound_1000hr_load | Sound 1000hr wood load (tons ac-1, Mg ha-1) | 8 |
| Woody_sound_10khr_load | Sound 10,000hr wood load (tons ac-1, Mg ha-1) | 3 |
| Woody_sound_GT10k_load | Sound >10,000hr wood load (tons ac-1, Mg ha-1) | 0 |
| Woody_rotten_1000hr_load | Rotten 1000hr wood load (tons ac-1, Mg ha-1) | 3 |
| Woody_rotten_10k_load | Rotten 10,000hr wood load (tons ac-1, Mg ha-1) | 1.5 |
| Woody_rotten_GT10k_load | Rotten >10,000hr wood load (tons ac-1, Mg ha-1) | 0 |
| Woody_pile_load | Pile load (tons ac-1, Mg ha-1) | 0.04 |
| Woody_stumps_sound_load | Sound stump load (tons ac-1, Mg ha-1) | 0.04 |
| Woody_stumps_rotten_load | Rotten stump load (tons ac-1, Mg ha-1) | 0.03 |
| Woody_stumps_lightered_load | Lightered stump load (tons ac-1, Mg ha-1) | |
| LLM_litter_load | Litter load (tons ac-1, Mg ha-1) | 1.52 |
| LLM_lichen_load | Lichen load (tons ac-1, Mg ha-1) | 0.00 |
| LLM_moss_load | Moss load (tons ac-1, Mg ha-1) | 0.13 |
| Ground_upperduff_load | Upper duff load (tons ac-1, Mg ha-1) | 3.4 |
| Ground_lowerduff_load | Lower duff load (tons ac-1, Mg ha-1) | 15.3 |
| Ground_basalaccum_load | Basal accumulation load (tons ac-1, Mg ha-1) | 0.08 |
| Ground_squirrelmid_load | Squirrel midden load (tons ac-1, Mg ha-1) | |
| Total_aboveground_biomass | Total aboveground biomass (tree and shrub crowns excluded from this sum) (tons ac-1, Mg ha-1) | 56.01 |
| Depth_shrub | Depth of shrub stratum (ft, m) | |
| Depth_herb | Depth of herb stratum (ft, m) | 1 |
| Depth_wood | Depth of wood stratum (ft, m) | 0.08 |
| Depth_LLM | Depth of litter-lichen-moss stratum (ft, m) | 0.1 |
| Depth_Surface_Fuels | Depth of surface fuels (ft, m) | 0.04 |
| PercentCover_shrub | Percent cover of shrub stratum (%) | |
| PercentCover_herb | Percent cover of herb stratum (%) | 11 |
| PercentCover_wood | Percent cover of downed wood stratum (%) | 45 |
| PercentCover_LLM | Percent cover of litter-lichen-moss stratum (%) | 100 |
| Version | FCCS version number | 3.0.197 |