sim_dem: Simulates a fractal DEM

In habtools: Tools and Metrics for 3D Surfaces and Objects

Simulates a fractal DEM

Description

Simulates z-values based on the Diamond-square algorithm.

Usage

sim_dem(
  L,
  smoothness,
  H,
  R,
  plot = FALSE,
  prop = 0.1,
  n = 100,
  method = "area",
  parallel = FALSE
)

Arguments

L	The extent.
smoothness	A value between 0.0 and 1.0 (lower values produce rougher DEM).
H	Desired height range (optional).
R	Desired rugosity value (optional).
plot	Logical. Plot the simulated DEM during simulation? Only relevant if R is provided.
prop	Proportion of cells that undergo smoothing at each iteration when R is provided.
n	Number of iterations to try and reach desired R. Recommended to adapt R and H instead of increasing n if simulation fails.
method	The method to be used for rugosity calculation in case R is given. Can be "hvar" or "area"
parallel	Logical. Use parallel processing? Defaults to FALSE. Only relevant if method = "hvar".

Details

Warning: this function gets slow for n > 128. If H is provided, the simulated DEM is rescaled based on the value for H. If R is provided, a DEM is simulated using the same algorithm based on R, H, and the predicted D based on rdh_theory(), while smoothness is ignored. From that first simulated DEM, R is calculated and the DEM undergoes smoothing at each iteration until the rugosity approximates the inputted R. Argument prop defined the proportion of random cells of the DEM that are smoothed by averaging the z values of cell and neighboring cells at each iteration. Caution: When R is provided, the DEM may become increasingly less fractal as it is modified at each iteration.

Value

Digital elevation model of class RasterLayer.

Examples

library(raster)
dem <- sim_dem(L = 32, smoothness = 0.5)
plot(dem)
dem <- sim_dem(L = 32, smoothness = 0.2, H = 20)
plot(dem)

habtools documentation built on May 29, 2024, 7:30 a.m.