get_lacunarity: Calculate crown lacunarity from a tree crown
In tReeTraits: Calculate Tree Traits from Terrestrial Lidar

View source: R/traits_from_point_cloud.R

get_lacunarity

R Documentation

Calculate crown lacunarity from a tree crown

Description

This function calculates the lacunarity or "porosity" of a tree crown by defined as 1 - the ratio of a voxelized crown hull and a convex hull. See 'voxel_hull_2D()' and 'convex_hull_2D()'

Usage

get_lacunarity(las, res = 0.1, angle = 0)

Arguments

`las`	'LAS' object from 'lidR' package representing the CROWN of a tree. Crowns must be segmented using [segment_crown()].
`res`	numeric - resolution of voxelization
`angle`	numeric - in degrees, rotation angle about Z axis.

Value

A numeric value representing crown lacunarity (unitless).

Examples

las = lidR::readLAS(system.file("extdata", "tree_0744.laz", package="tReeTraits"))
cbh = get_crown_base(las, threshold=0.25, sustain=2)
las = segment_crown(las, cbh)
get_crown_volume_voxel(las)
get_crown_volume_alpha(las)
sf::st_area(convex_hull_2D(las)) #profile area, convex hull
sf::st_area(voxel_hull_2D(las)) #profile area, voxel hull
get_lacunarity(las)

tReeTraits documentation built on Feb. 26, 2026, 1:07 a.m.