Learn R Programming

landscapemetrics (version 1.5.6)

lsm_p_shape: SHAPE (patch level)

Description

Shape index (Shape metric)

Usage

lsm_p_shape(landscape, directions = 8)

Value

tibble

Arguments

landscape

Raster* Layer, Stack, Brick, SpatRaster (terra), stars, 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).

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: https://www.umass.edu/landeco/

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

Run this code
lsm_p_shape(landscape)

Run the code above in your browser using DataLab