Subject: Metric Option for SVS Images
Name: Don Robinson, Robert Havis, partially supported by Mr. Murray
Woods at the Ontario Ministry of Natural Resources
Date: May 9, 2005
Variants affected: ALL

fvs/base/src/svestb.f
fvs/base/src/svgrnd.f
fvs/base/src/svgtpl.f
fvs/base/src/svgtpt.f
fvs/base/src/svinit.f
fvs/base/src/svkey.f
fvs/base/src/svout.f
fvs/base/src/svrmov.f
fvs/common/SVDATA.F77
fvs/fire/base/src/fmsvfl.f
fvs/fire/base/src/fmsvout.f
fvs/fire/base/src/fmsvtree.f
fvs/ppbase/src/getstd.f
fvs/ppbase/src/putstd.f

Description:

This code update creates a metric output option for SVS images.
FVS runs are unchanged. Users have the option of generating SVS output
based on the metric system (1 ha plots, DBH (cm), height (m)). All
combinations of current SVS keyword flags create outputs that are
identical (within SVS accuracy) to the non-metric outputs. These
include visual stand rendering (perspective view, overhead view,
profile view), graphical output (dbh, height and species distribution,
crown structure) and stand summary table.

A 6th field was added to the SVS keyword.

field 6: render SVS output in metric or imperial units (Default = 0)
	0		output is generated in imperial units
	1		output is generated in metric units

Note:
When rendering a perspective view of the stand using metric units
(field 6 = 1), the command line flags of SVS may need to be altered so
that a "classic" SVS stand view is drawn. Otherwise, the point of view
for the rendering will be too far from the stand. Suggested command-line
parameters for the square stand metric rendering are:

  -A315 -E82 -S38 -D226 -L51

In comparison, the default imperial rendering command line arguments
are:

  -A315 -E172 -S30 -D472 -L105

Stand and flame renderings and snag information from the FFE are also
available.

Impact on users: Metric SVS images can be produced using field 6 of
                 of the SVS keyword.

Files:

fvs/common/svdata.f77
- a flag variable IMETRIC was added to the SVDATA common block. The
  common block also contains PARAMETER declarations for a number of
  imperial-metric conversion constants. 

fvs/base/src/svestb.for
- stem (/acre) -> (/ha);
- crown diameter (ft) -> (m)

fvs/base/src/svgrnd.for
- fire line (ft) -> (m)

fvs/base/src/svgtpl.for
- plot edge calculations (ft) -> (m)

fvs/base/src/svgtpt.for
- argument to pass IMETRIC flag
- plot location object calculations (ft) -> (m)

fvs/base/src/svinit.for
- initialize IMETRIC

fvs/base/src/svkey.for
- new fld6 argument for SVS keyword (see additional notes below)

fvs/base/src/svout.for
- SVS commands revised
- plot edge drawing 
- range poles (30ft) -> (5m)
- tree and snags location and dimensions:
- dbh (in) -> (cm)
- height (ft) -> (m)
- crown diameter (ft) -> (m)

fvs/base/src/svrmov.for
- assign FVS records to SVS records; live stems and snags
- stems (ac) -> (ha)
- crown diameter (ft) -> (m)

fvs/fire/base/src/fmsvfl.for
- fire line dimensions and limits (ft) -> (m)

fvs/fire/base/src/fmsvout.for
- flame location (ft) -> (m)

fvs/fire/base/src/fmsvtree.for
- flame dimensions and location within trees (ft) -> (m)

fvs/ppbase/src/getstd.for
- get IMETRIC from PPE binary file

fvs/ppbase/src/putstd.for
- put IMETRIC to PPE binary file

