treeVolume: Calculate volume for trees

In bcgov/FAIBBase: Basic functions for forest mensuration and ecology

Calculate volume for trees

Description

This function is to calculate tree volume such as the whole stem volume (VOL_WSV), merchantable volume (VOL_MER) and stump volume (STUMP).

Usage

treeVolume(
  taperEquationForm = "KBEC",
  FIZorBEC,
  species,
  DBH,
  height,
  BTOPHeight = NA,
  volumeName = "WSV",
  stumpHeight = 0.3,
  UTOPDIB = 10
)

Arguments

taperEquationForm	character, Specifies which taper equations will be used, currently support KBEC or KFIZ3. KBEC is the Kozak's equations (2002 version) based on BEC zone, tree sizes and species. KFIZ3 is the equations based on forest inventory zone (FIZ), tree sizes and species. Default is KBEC, if missing.
FIZorBEC	character, Specifies which FIZ or BEC (depends on taperEquationForm) zones the tree located in BC.
species	character, Tree species, must be BC species code.
DBH	numeric, DBH of the tree in cm.
height	numeric, Total tree height in meter.
BTOPHeight	numeric, Height at broken top in meter. NA suggests no broken top. If missing, the default is NA.
volumeName	character, Indicates which volume you want to derive. It supports the whole stem volume (WSV), merchantable volume (MER) or stump volume (STUMP). The merchantable volume is the whole stem volume minus volume of stump and volume less than minimum utility diameter (UTOPDIB). If missing, the default is WSV.
stumpHeight	numeric, Defines stump height. If missing, 0.3 m is used. It will be called to calculate the merchantable volume.
UTOPDIB	numeric, Merchantable inside-bark diameter. If missing, UTOP is 10. It will be called to calculate the merchantable volume.

Value

volume

Note

For the volume between 0 and 0.3, also known as stump volume, the function calculates the volume as cylinder with the diameter of stump height. In the case of the diameter at stump height is less than diameter at breast height, the diameter at breast height is used as stump height. It calculates tree volume based on a 10 cm slices starting from 0.3 m tall using Smalian’s formula.

Author(s)

Yong Luo

See Also

treeVolCalculator and treeProfile

Examples

## Not run: 
treeA_wsv <- treeVolume(FIZorBEC = "CWH",
                        species = "H",
                        DBH = 30.7,
                        height = 27.4,
                        BTOPHeight = 5.6)
trees_wsv <- treeVolume(FIZorBEC = "CWH",
                        species = c("H", "S", "H"),
                        DBH = c(30.7, 42.3, 11.2),
                        height = c(27.4, 37.3, 11.6),
                        BTOPHeight = c(5.6, NA, NA))
trees_mer <- treeVolume(FIZorBEC = "CWH",
                        volumeName = "MER",
                        species = c("H", "S", "H"),
                        DBH = c(30.7, 42.3, 11.2),
                        height = c(27.4, 37.3, 11.6),
                        BTOPHeight = c(5.6, NA, NA))

## End(Not run)

bcgov/FAIBBase documentation built on June 19, 2024, 11:57 p.m.