Skip to contents

LSI (landscape level)

Source: R/lsm_l_lsi.R
lsm_l_lsi.Rd

Landscape shape index (Aggregation metric)

Usage

lsm_l_lsi(landscape)

Arguments

landscape

A categorical raster object: SpatRaster; Raster* Layer, Stack, Brick; stars or a list of SpatRasters.

Value

tibble

Details

$$LSI = \frac{E} {\min E}$$ where \(E\) is the total edge length in cell surfaces and \(\min E\) is the minimum total edge length in cell surfaces.

LSI is an 'Aggregation metric'. It is the ratio between the actual landscape edge length and the hypothetical minimum edge length. The minimum edge length equals the edge length if only one patch would be present.

Because the metric is based on distances or areas please make sure your data is valid using check_landscape.

Units

None

Ranges

LSI >= 1

Behaviour

Equals LSI = 1 when only one squared patch is present. Increases, without limit, as the length of the actual edges increases, i.e. the patches become less compact.

References

McGarigal K., SA Cushman, and E Ene. 2023. FRAGSTATS v4: Spatial Pattern Analysis Program for Categorical Maps. Computer software program produced by the authors; available at the following web site: https://www.fragstats.org

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

See also

lsm_p_shape,
lsm_c_lsi

Examples

landscape <- terra::rast(landscapemetrics::landscape)
lsm_l_lsi(landscape)
#> # A tibble: 1 × 6
#>   layer level     class    id metric value
#>   <int> <chr>     <int> <int> <chr>  <dbl>
#> 1     1 landscape    NA    NA lsi     3.83