leaf_geometry: Calculates leaf orientation

View source: R/radiationtools.R

leaf_geometryR Documentation

Calculates leaf orientation

Description

leaf_geometry is used to calculates the ratio of vertical to horizontal projections of leaf foliage.

Usage

leaf_geometry(veghgt, maxx = 8)

Arguments

veghgt

a raster object, two-dimensional array or matrix of vegetation heights (m).

maxx

a theoretical upper limit for the ratio of vertical to horizontal projections of leaf foliage, to which all values are capped.

Details

Under vegetated canopies, canopy transmission not only decreases with canopy cover but is also affected by leaf structure. At low solar angles, radiation is lower when leaves are more vertically oriented and leaf_geometry is hence used to calculate an approximate factor indicating the degree to which vegetation is vertically orientated based on the premise that shorter vegetation is more likely to have more vertically orientated leaves. If veghgt is a raster object, a raster object is returned. This function has been calibrated using data derived from a small area of Cornwall only. It is strongly recommended that locally calibrated values units of x, y and z are identical. Use projectRaster() to convert the projection to a Universal Transverse Mercator type projection system.

Value

a raster object or a two-dimensional array of numeric values representing the ratio of vertical to horizontal projections of leaf foliage. The output tends towards zero as vegetation is more vertically orientated and maxx as it is more horizontally orientated.

Examples

library(raster)
x <- leaf_geometry(veg_hgt)
plot(x, main = "Leaf geometry")

ilyamaclean/microclima documentation built on Oct. 31, 2023, 11:41 p.m.