habtools (version 1.1.1)

fd_area: Calculate fractal dimension using the surface area method

Description

Calculate fractal dimension using the surface area method

Usage

fd_area(data, lvec = NULL, keep_data = FALSE, plot = FALSE, scale = FALSE)

Value

A value for fractal dimension, typically between 2 and 3 or a list if keep_data = TRUE.

Arguments

data

DEM of class "RasterLayer" or mesh of class "mesh3d".

lvec

Vector of scales to use for calculation.

keep_data

Logical. Keep data? Default is FALSE.

plot

Logical. Plot surface with area resolutions superimposed? Defaults to FALSE.

scale

Logical. Rescale height values to fit the extent? Only relevant for DEMs. Defaults to FALSE.

Details

This function calculates fractal dimension using the area method. Based on values in lvec, the DEM or mesh is reprojected to varying scales. Fractal dimension is defined as 2 - s with s being the slope of the regression between the log-transformed surface areas across scales and the log-transformed scales. Considerate bias is introduced if scales approach the extent of the object due to an edge effect. Therefore, this approach is only appropriate when the object is large relative to the scales of interest to be used as lvec. Diagnostic plots may help visualize whether bias is present for the scales chosen (i.e. points do not fall on a straight line).

Examples

fd_area(horseshoe, lvec = c(0.125, 0.25, 0.5))

# Look at diagnostic plot
fdata <- fd_area(horseshoe, lvec = c(0.05, 0.1, 0.2, 0.4), keep_data = TRUE)
fd_diagnose(fdata)
# points fall on straight line

fdata <- fd_area(horseshoe, lvec = c(0.5, 1, 2, 4), keep_data = TRUE)
fd_diagnose(fdata)
# points fall on hollow curve, indicating that lvec includes values that
# are too high.