Skip to contents

nlm_percolation

Source: R/nlm_percolation.R
nlm_percolation.Rd

Generates a random percolation neutral landscape model.

Usage

nlm_percolation(ncol, nrow, resolution = 1, prob = 0.5)

Arguments

ncol

[numerical(1)]
Number of columns forming the raster.

nrow

[numerical(1)]
Number of rows forming the raster.

resolution

[numerical(1)]
Resolution of the raster.

prob

[numerical(1)]
Probability value for setting a cell to 1.

Value

RasterLayer

Details

The simulation of a random percolation map is accomplished in two steps:

  • Initialization: Setup matrix of size (ncol*nrow)

  • Map generation: For each cell in the matrix a single uniformly distributed random number is generated and tested against a probability prob. If the random number is smaller than prob, the cell is set to TRUE - if it is higher the cell is set to FALSE.

References

1. Gardner RH, O'Neill R V, Turner MG, Dale VH. 1989. Quantifying scale-dependent effects of animal movement with simple percolation models. Landscape Ecology 3:217 - 227.

2. Gustafson, E.J. & Parker, G.R. (1992) Relationships between landcover proportion and indices of landscape spatial pattern. Landscape Ecology , 7, 101 - 110.

Examples

# simulate percolation model
percolation <- nlm_percolation(ncol = 100, nrow = 100, prob = 0.5)
if (FALSE) {
# visualize the NLM
landscapetools::show_landscape(percolation)
}