landscapemetrics (version 1.4.4)

lsm_p_shape: SHAPE (patch level)

Description

Shape index (Shape metric)

Usage

lsm_p_shape(landscape, directions)
# S3 method for RasterLayer
lsm_p_shape(landscape, directions = 8)
# S3 method for RasterStack
lsm_p_shape(landscape, directions = 8)
# S3 method for RasterBrick
lsm_p_shape(landscape, directions = 8)
# S3 method for stars
lsm_p_shape(landscape, directions = 8)
# S3 method for list
lsm_p_shape(landscape, directions = 8)

Arguments

landscape

Raster* Layer, Stack, Brick or a list of rasterLayers.

directions

The number of directions in which patches should be connected: 4 (rook's case) or 8 (queen's case).

Value

tibble

Details

$$SHAPE = \frac{p_{ij}} {\min p_{ij}}$$ where \(p_{ij}\) is the perimeter in terms of cell surfaces and \(\min p_{ij}\) is the minimum perimeter of the patch in terms of cell surfaces.

SHAPE is a 'Shape metric'. It describes the ratio between the actual perimeter of the patch and the hypothetical minimum perimeter of the patch. The minimum perimeter equals the perimeter if the patch would be maximally compact.

Units

None

Range

SHAPE >= 1

Behaviour

Equals SHAPE = 1 for a squared patch and increases, without limit, as the patch shape becomes more complex.

References

McGarigal, K., SA Cushman, and E Ene. 2012. FRAGSTATS v4: Spatial Pattern Analysis Program for Categorical and Continuous Maps. Computer software program produced by the authors at the University of Massachusetts, Amherst. Available at the following web site: http://www.umass.edu/landeco/research/fragstats/fragstats.html

Patton, D. R. 1975. A diversity index for quantifying habitat "edge". Wildl. Soc.Bull. 3:171-173.

See Also

lsm_p_perim, lsm_p_area, lsm_c_shape_mn, lsm_c_shape_sd, lsm_c_shape_cv, lsm_l_shape_mn, lsm_l_shape_sd, lsm_l_shape_cv

Examples

# NOT RUN {
lsm_p_shape(landscape)

# }