BA.Larger.Trees: Basal Area in Larger Trees

In ryanmismith/inventoryfunctions: Forestry Inventory Functions

Basal Area in Larger Trees

Description

This function requires that your data.frame be sorted as detailed in examples before running.

This function calculates the cumulative basal areas of larger trees within a plot. This function must be run with the same sorting function as the CCFL function. Please refer to details for explanation of outputs and required inputs, as this function will not run without properly sorting your inventory as demonstrated in the details and/or examples. The basal area for measured trees must be computed first using the BA function.

Usage

BA.Larger.Trees(ID, DBH, BA, EXPF)

Arguments

DBH	Diameter at breast height in cm.
BA	Basal area of each tree in sq meters. Can be calculated with the BA function.
EXPF	A trees expansion factor. Can be calculated using the EXP.F function.
Unique.ID	Unique Plot ID defined by the Unique.ID function

Details

This function uses the dplyr package to select, arrange, and mutate the data.

This function requires that your data frame be sorted as such prior to running:

df <- df %>% group_by(ID) %>% arrange(desc(DBH), .by_group = TRUE)

Your data should include unique IDs specific to each plot. If you have not done this, it can be done using the Unique.ID function included in this package.

This function is a dependency for a variety of additional functions in the inventoryfunctions package, and the example inventory script included in this package will demonstrate how to execute it prior to running those additional dependencies. Thus, it is recommended that you run the function into an object named BAL in your data.frame or tibble.

Value

The function returns BAL values for every tree in sq. meters as a numeric vector of length n.

Author(s)

Ryan Smith

See Also

BA

Unique.ID

CCF.Larger

EXPF.F

Other Values in Larger Trees: CCF.Larger()

Other Basal Area Functions: BAPH(), BA()

Other Plot Level Functions: BAPH(), CCF.Larger(), CrownCompF(), DBHFuns(), HeightPredict(), RD(), SDI.Max(), SDI.Plot(), TPH(), TallestTrees(), Unique.ID()

Examples

## Not run: 
# trees_2010 <- trees_2010 %>%
   dplyr::group_by(ID) %>%
   dplyr::arrange(desc(DBH), .by_group = TRUE)

 trees_2010 <- trees_2010 %>%
 dplyr::mutate(
    BAL = BA.Larger.Trees(ID, DBH, BA, EXPF)
  )

## End(Not run)

ryanmismith/inventoryfunctions documentation built on Aug. 5, 2022, 2:22 a.m.