Subject: Lake States Fire and Fuels Extension and new FFE keywords
Name:  Stephanie Rebain
Date:  09/08/2005
Variants affected: ALL FFE variants

Description:
The Fire and Fuels Extension to FVS has been calibrated for the Lake States area.

Because LS-FFE uses the native plant community in its fuel model selection logic,
native plant community codes should be set for stands using LS-FFE.  The native plant
community codes are from:

Minnesota Department of Natural Resources (2003).  Field Guide to the Native Plant
Communities of Minnesota: the Laurentian Mixed Forest Province.  Ecological Land
Classification Program, Minnesota County Biological Survey, and Natural Heritage
and Nongame Research Program.  MNDNR St. Paul, MN.

The NPC codes are as follows:

  1:{FDn12 Northern Dry-Sand Pine Woodland}
  2:{FDn22 Northern Dry-Bedrock Pine (Oak) Woodland}
  3:{FDn32 Northern Poor Dry-Mesic Mixed Woodland}
  4:{FDn33 Northern Dry-Mesic Mixed Woodland}
  5:{FDn43 Northern Mesic Mixed Forest}
  6:{FDc12 Central Poor Dry Pine Woodland}
  7:{FDc23 Central Dry Pine Woodland}
  8:{FDc24 Central Rich Dry Pine Woodland}
  9:{FDc25 Central Dry Oak-Aspen (Pine) Woodland}
  10:{FDc34 Central Dry-Mesic Pine-Hardwood Forest}
  11:{MHn35 Northern Mesic Hardwood Forest}
  12:{MHn44 Northern Wet-Mesic Boreal Hardwood-Conifer Forest}
  13:{MHn45 Northern Mesic Hardwood (Cedar) Forest}
  14:{MHn46 Northern Wet-Mesic Hardwood Forest}
  15:{MHn47 Northern Rich Mesic Hardwood Forest}
  16:{MHc26 Central Dry-Mesic Oak-Aspen Forest}
  17:{MHc36 Central Mesic Hardwood Forest (Eastern)}
  18:{MHc37 Central Mesic Hardwood Forest (Western)}
  19:{MHc47 Central Wet-Mesic Hardwood Forest}
  20:{FFn57 Northern Terrace Forest}
  21:{FFn67 Northern Floodplain Forest}
  22:{WFn53 Northern Wet Cedar Forest}
  23:{WFn55 Northern Wet Ash Swamp}
  24:{WFn64 Northern Very Wet Ash Swamp}
  25:{WFs57 Southern Wet Ash Swamp}
  26:{WFw54 Northwestern Wet Aspen Forest}
  27:{FPn62 Northern Rich Spruce Swamp (Basin)}
  28:{FPn63 Northern Cedar Swamp}
  29:{FPn71 Northern Rich Spruce Swamp (Water Track)}
  30:{FPn72 Northern Rich Tamarack Swamp (Eastern Basin)}
  31:{FPn73 Northern Alder Swamp}
  32:{FPn81 Northern Rich Tamarack Swamp (Water Track)}
  33:{FPn82 Northern Rich Tamarack Swamp (Western Basin)}
  34:{FPs63 Southern Rich Conifer Swamp}
  35:{FPw63 Northwestern Rich Conifer Swamp}
  36:{APn80 Northern Spruce Bog}
  37:{APn81 Northern Poor Conifer Swamp}
  38:{APn90 Northern Open Bog}
  39:{APn91 Northern Poor Fen}
  40:{CTn11 Northern Dry Cliff}
  41:{CTn12 Northern Open Talus}
  42:{CTn24 Northern Scrub Talus}
  43:{CTn32 Northern Mesic Cliff}
  44:{CTn42 Northern Wet Cliff}
  45:{CTu22 Lake Superior Cliff}
  46:{ROn12 Northern Bedrock Outcrop}
  47:{ROn23 Northern Bedrock Shrubland}
  48:{LKi32 Inland Lake Sand/Gravel/Cobble Shore}
  49:{LKi43 Inland Lake Rocky Shore}
  50:{LKi54 Inland Lake Clay/Mud Shore}
  51:{LKu32 Lake Superior Sand/Gravel/Cobble Shore}
  52:{LKu43 Lake Superior Rocky Shore}
  53:{RVx32 Sand/Gravel/Cobble River Shore}
  54:{RVx43 Rocky River Shore}
  55:{RVx54 Clay/Mud River Shore}
  56:{OPn81 Northern Shrub Shore Fen}
  57:{OPn91 Northern Rich Fen (Water Track)}
  58:{OPn92 Northern Rich Fen (Basin)}
  59:{OPn93 Northern Extremely Rich Fen}
  60:{WMn82 Northern Wet Meadow/Carr}
  61:{MRn83 Northern Mixed Cattail Marsh}
  62:{MRn93 Northern Bulrush-Spikerush Marsh}
  63:{MRu94 Lake Superior Coastal Marsh}

Users of LS-FFE should set these codes in their stand list file, input database,
or thru the StdInfo keyword. 
 
The LS fuel model logic uses the season of the burn to determine the fuel model
and in its fire-related mortality predictions.  As a result, a new keyword, 
POTFSEAS, was created so that users can control the season of potential fires.  
Also, a new field was added to the SimFire keyword so that users can control 
the season of simulated fires.  The season of the fire does not affect FFE for 
other variants.

Also, the keyword POTFPAB was created so that users can control the percentage of
the stand area that is assumed burned for potential fires, which is used in the 
fire effect calculations.  (There is already a way to control this for simulated 
fires.)

The new and altered FFE keywords:

POTFPAB - controls the percentage of the stand area burned for potential fire
calculations.  
Field 1: percentage of the stand area burned for potential severe fires;
          default is 100%.
Field 2: percentage of the stand area burned for potential moderate fires;
          default is 100%.

POTFSEAS - controls the season of the burn for potential fire calculations.
           (Currently used in LS-FFE only.)
Field 1: season of the burn for potential severe fires.
           1 = early spring (compact leaves), 2 = before greenup, 
           3 = after greenup (before fall), 4 = fall
          default is 1.
Field 2: season of the burn for potential moderate fires.
           1 = early spring (compact leaves), 2 = before greenup, 
           3 = after greenup (before fall), 4 = fall 
          default is 1.

SIMFIRE - signals that a fire and its effects should be simulated and specify 
some of the environmental conditions for the fire.
Field 1: the FVS cycle number or the calendar year; default is 1.
Field 2: Windspeed in miles per hour 20 ft. above the vegetation; default is 20.
Field 3: Nominal moisture level.  If the MOISTURE keyword is used, the value in 
         this field is ignored; the default is 1=very dry.
Field 4: Temperate (F); default is 70.
Field 5: Mortality Code.  0 = Turn off FFE mortality predictions, 1 = FFE estimates mortality.
Field 6: Percentage of stand area burned; default is 100.
Field 7: Season of the burn.  1 = early spring (compact leaves), 2 = before greenup, 
         3 = after greenup (before fall), 4 = fall; default is 1. (Used in LS-FFE only.)
 
Impact on users:
There should be no change in output.  LS-FFE users will need to download the latest
versions of Suppose and FVS.  Other FFE users should download new software if they 
want to use the new POTFPAB keyword.

Files:
fire/ls/src/fmvinit.f - LS-specific variable initialization
fire/ls/src/fmsnag.f - sets the new LS snag fall and snag decay relationships
fire/ls/src/fmcba.f - sets the LS default surface fuel loads
fire/ls/src/fmlsft.f - calculates a forest type from FIA forest type
fire/ls/src/fmmois.f - LS default fuel moistures
fire/ls/src/fmcrow.f - LS crown biomass routine
fire/ls/src/fmbrkt.f - LS bark thickness values
fire/ls/src/fmcfmd.f - LS fuel model logic

fire/base/src/fmscro.f - put in the new snag decay info for the LS variant
fire/base/src/fmfout.f - made sure the LS variant was handled properly
fire/base/src/fmburn.f - made sure the LS variant was handled properly,
                         added processing of new field on SIMFIRE to control
                         simulated fire season in fire behavior calculations
fire/base/src/fmpofl.f - made sure the LS variant was handled properly, 
                         passed in potpab (potential fire percent area burned) 
                         to the fire effects routines instead 
                         of assuming 100%, set burnseas to control the season
                         assumed in the potential fire calculations
fire/base/src/fmcrowls.f - crown biomass equations for the LS variant,
                         goes in fire/base since other eastern FFE variants may call this
fire/base/src/fminit.f - initialized potpab, potseas, and burnseas
fire/base/src/fmin.f - added two new keyword - potfpab and potfseas - to control 
                       the potential fire season and the potential fire percent 
                       area burned assumed, altered the processing of simfire to
                       account for the new parameter (season of burn), deleted
                       unnecessary declarations
fire/base/src/fmeff.f - made a correction so that setting potential fire percent
                        area burned would work, made some mortality changes for LS-FFE

fire/base/common/fmfcom.f77 - added potpab, potseas, and burnseas

fire/ppe/src/fmppget.f - added potpab, potseas, and burnseas
fire/ppe/src/fmppput.f - added potpab, potseas, and burnseas

dbs/src/dbsfmpf.f - made sure the LS variant was handled properly

ls/src/grinit.f - set default plant community code
ls/src/habtyp.f - new file with LS plant community codes

ls/obj/makefile - changed it so the new LS/habtyp.f is used
bin/makefile - added LSFM
fire/ls/obj/makefile - created this to compile LSFM