Skip to contents

AI (class level)

Source: R/lsm_c_ai.R
lsm_c_ai.Rd

Aggregation index (Aggregation metric)

Usage

lsm_c_ai(landscape)

Arguments

landscape

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

Value

tibble

Details

$$AI = \Bigg[\frac{g_{ii}}{max-g_{ii}} \Bigg](100) $$

where \(g_{ii}\) is the number of like adjacencies based on the single-count method and \(max-g_{ii}\) is the classwise maximum number of like adjacencies of class i.

AI is an 'Aggregation metric'. It equals the number of like adjacencies divided by the theoretical maximum possible number of like adjacencies for that class. The metric is based on he adjacency matrix and the the single-count method.

Units

Percent

Range

0 <= AI <= 100

Behaviour

Equals 0 for maximally disaggregated and 100 for maximally aggregated classes.

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

He, H. S., DeZonia, B. E., & Mladenoff, D. J. 2000. An aggregation index (AI) to quantify spatial patterns of landscapes. Landscape ecology, 15(7), 591-601.

See also

lsm_l_ai

Examples

landscape <- terra::rast(landscapemetrics::landscape)
lsm_c_ai(landscape)
#> # A tibble: 3 × 6
#>   layer level class    id metric value
#>   <int> <chr> <int> <int> <chr>  <dbl>
#> 1     1 class     1    NA ai      79.7
#> 2     1 class     2    NA ai      79.6
#> 3     1 class     3    NA ai      84.9