Subject: FFE Restructuring update
Name:  Stephanie Rebain
Date:  07/03/2014
Variants affected: All

Description:

1)  FFE was restructured to run on cycles, rather than annually.  This results in significantly faster model speeds 
and reporting years matching the base FVS model.  Also, the order of the FFE model has been changed to be more consistent.
All of the activities (salvages, simulated fires, pileburns, and others) are modelled first.  Second, all of the reports
are printed.  Third, all of the various pools are updated with regard to snag fall, snag height loss, snag decay, down wood
decay and down wood accumulation.  As a result of this change, all reports and event monitor variables and functions now print
post-activity values.  Also, the values reported for the initial year represent the inventory conditions and do not
incorporate a year of change (such as decay and accumulation when looking at the down wood values).

Impact on users:
Users should download new executables if desired.  Output values will be different due to this change.  Note, the interpretation
of some output (whether it is a pre-activity or post-activity value) has changed.  The last argument of the SNAGS function,
which let users select from pre or post-salvage values, has been eliminated.  Because of small differences in modelled fuel loads,
users may expect small differences in potential and simulated fire behavior.  Other differences in snag estimates, fuel consumption
estimates and other values may occur due to the change in timing as to when calculations are done relative to when reports are printed.

Modified Files:
fire/base/src/fmburn.f - adjusted keyword processing, reporting years, and deleted code that is now in fmcfmd3
fire/base/src/fmcadd.f - adjusted crown additions to the down wood pools, moved section that adds salvaged snag crowns to cwd pools to fmsalv, fixed comments
fire/base/src/fmcfmd2.f - adjusted keyword processing, added new subroutine (fmcfmd3) that sets up the modelled loads option and selects the fuel model.
fire/base/src/fmchrvout.f  - adjusted reporting years
fire/base/src/fmcrbout.f  - adjusted reporting years
fire/base/src/fmcwd.f - adjusted decay rates, deleted fuel move processing
fire/base/src/fmdout.f  - adjusted reporting years
fire/base/src/fmeff.f  - fixed comments
fire/base/src/fmevmon.f  - adjusted processing of snags function so values match the snag reports
fire/base/src/fmfout.f  - adjusted reporting years
fire/base/src/fmmain.f - big changes to the ffe sequencing order
fire/base/src/fmpocr.f - adjusted reporting year
fire/base/src/fmpofl.f  - adjusted reporting years
fire/base/src/fmsalv.f - added section that adds salvaged snag crowns to cwd pools (used to be in fmcadd), fixed comments
fire/base/src/fmscro.f -  adjusted snag crown fall estimates, fixed comments
fire/base/src/fmscut.f - avoided unnecessary calculations
fire/base/src/fmsdit.f - fixed comments
fire/base/src/fmsnag.f - adjusted snag dynamics
fire/base/src/fmsnght.f - adjusted snag height loss calculations
fire/base/src/fmsout.f - adjusted reporting years
fire/base/src/fmtret.f - adjusted keyword processing, 
                         added new subroutine (fmfmov) for processing of fuelmove keyword.
                         added new call to fmscro to make sure we don't miss the crowns of pileburn-killed trees
fire/base/src/fmusrfm.f - adjusted keyword processing
metric/fire/base/src/fmdout.f - adjusted reporting years
metric/fire/base/src/fmfout.f - adjusted reporting years
metric/fire/base/src/fmpofl.f - adjusted reporting years
metric/fire/base/src/fmsout.f - adjusted reporting years

fire/base/common/FMCOM.F77 - updated a comment

fire/ak/src/fmcrow.f - added debug statement
fire/bc/src/fmcrow.f - added debug statement
fire/bm/src/fmcrow.f - added debug statement
fire/ca/src/fmcrow.f - added debug statement
fire/ci/src/fmcrow.f - added debug statement
fire/cr/src/fmcrow.f - added debug statement
fire/cs/src/fmcrow.f - added debug statement
fire/ec/src/fmcrow.f - added debug statement
fire/em/src/fmcrow.f - added debug statement
fire/ie/src/fmcrow.f - added debug statement
fire/kt/src/fmcrow.f - added debug statement
fire/ls/src/fmcrow.f - added debug statement
fire/nc/src/fmcrow.f - added debug statement
fire/ne/src/fmcrow.f - added debug statement
fire/pn/src/fmcrow.f - added debug statement
fire/sn/src/fmcrow.f - added debug statement
fire/so/src/fmcrow.f - added debug statement
fire/tt/src/fmcrow.f - added debug statement
fire/ut/src/fmcrow.f - added debug statement
fire/wc/src/fmcrow.f - added debug statement
fire/ws/src/fmcrow.f - added debug statement

fire/cs/src/fmsfall.f - edited logic for special post-burn snag fall rates
fire/ci/src/fmsfall.f - edited logic for special post-burn snag fall rates
fire/em/src/fmsfall.f - edited logic for special post-burn snag fall rates
fire/ls/src/fmsfall.f - edited logic for special post-burn snag fall rates
fire/ne/src/fmsfall.f - edited logic for special post-burn snag fall rates
fire/ni/src/fmsfall.f - edited logic for special post-burn snag fall rates
fire/pn/src/fmsfall.f - edited logic for special post-burn snag fall rates
fire/so/src/fmsfall.f - edited logic for special post-burn snag fall rates
fire/sn/src/fmsfall.f - edited logic for special post-burn snag fall rates
fire/ut/src/fmsfall.f - edited logic for special post-burn snag fall rates

Deleted Files:
fire/ppe/src/fmppput.f
fire/ppe/src/fmppget.f
fire/ppe/src/fmpphv.f

