landscapemetrics (version 1.4.4)

lsm_l_gyrate_cv: GYRATE_CV (landscape level)

Description

Coefficient of variation radius of gyration (Area and edge metric)

Usage

lsm_l_gyrate_cv(landscape, directions)
# S3 method for RasterLayer
lsm_l_gyrate_cv(landscape, directions = 8)
# S3 method for RasterStack
lsm_l_gyrate_cv(landscape, directions = 8)
# S3 method for RasterBrick
lsm_l_gyrate_cv(landscape, directions = 8)
# S3 method for stars
lsm_l_gyrate_cv(landscape, directions = 8)
# S3 method for list
lsm_l_gyrate_cv(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

$$GYRATE_{CV} = cv(GYRATE[patch_{ij}])$$ where \(GYRATE[patch_{ij}]\) equals the radius of gyration of each patch.

GYRATE_CV is an 'Area and edge metric'. The metric summarises the landscape as the Coefficient of variation of the radius of gyration of all patches in the landscape. GYRATE measures the distance from each cell to the patch centroid and is based on cell center-to-cell center distances. The metrics characterises both the patch area and compactness. The Coefficient of variation is scaled to the mean and comparable among different landscapes.

Units

Meters

Range

GYRATE_CV >= 0

Behaviour

Equals GYRATE_CV = 0 if the radius of gyration is identical for all patches. Increases, without limit, as the variation of the radius of gyration increases.

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

Keitt, T. H., Urban, D. L., & Milne, B. T. 1997. Detecting critical scales in fragmented landscapes. Conservation ecology, 1(1).

See Also

lsm_p_gyrate, cv, lsm_c_gyrate_mn, lsm_c_gyrate_sd, lsm_c_gyrate_cv, lsm_l_gyrate_mn, lsm_l_gyrate_sd

Examples

# NOT RUN {
lsm_l_gyrate_cv(landscape)

# }