BranchAngle: Estimation of the tree branch angle from an aRchi file

BranchAngleR Documentation

Estimation of the tree branch angle from an aRchi file

Description

Estimate the branch angle of a QSM. Two methods are possible (see method argument)

Usage

BranchAngle(aRchi, method = NULL, A0 = FALSE, level = "Tree")

## S4 method for signature 'aRchi'
BranchAngle(aRchi, method = NULL, A0 = FALSE, level = "Tree")

Arguments

aRchi

an object of class aRchi with at least a QSM and a path table

method

character. SegmentAngle or King98

A0

logical (default = FALSE). If TRUE the main axis to remove from the calculation is re-estimated using the Compute_A0 function. If false the default branch order 0 is kept.

level

character. The level at which the branch angle is computed. Tree for tree level; branching_order for branch order level; Axis one angle value per axis.

Details

The method "SegmentAngle" compute the angle by considering the first and the last cylinder or each segment, mean is then used for the level of organization selected.

The method "King98" compute the angle by considering the first and the last cylinder of each axis mean is then used for the level of organization selected.

The main axis is always removed.

Value

a numeric or data.table. The branch angle in degree at the selected level. with 0 a perfectly vertical branch angle, 90 a perfectly horizontal branch angle and > 90 a downward branch angle

References

Martin-Ducup, O. et al. Terrestrial laser scanning reveals convergence of tree architecture with increasingly dominant crown canopy position. Functional Ecology (2020).

Examples


# Read an aRchi file with a QSM and paths tables.
file=system.file("extdata","Tree_1_aRchi.aRchi",package = "aRchi")
Tree1_aRchi=read_aRchi(file)
# Compute the branch angle at various level
BranchAngle(Tree1_aRchi,method="SegmentAngle")
BranchAngle(Tree1_aRchi,level="branching_order",method="SegmentAngle",A0=TRUE)


aRchi documentation built on Sept. 3, 2022, 9:06 a.m.