Skip to contents

TA (landscape level)

Source: R/lsm_l_ta.R
lsm_l_ta.Rd

Total area (Area and edge metric)

Usage

lsm_l_ta(landscape, directions = 8)

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).

Value

tibble

Details

$$CA = sum(AREA[patch_{ij}])$$ where \(AREA[patch_{ij}]\) is the area of each patch in hectares.

TA is an 'Area and edge metric'. The total (class) area sums the area of all patches in the landscape. It is the area of the observation area.

Units

Hectares

Range

TA > 0

Behaviour

Approaches TA > 0 if the landscape is small and increases, without limit, as the size of the landscape 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

See also

lsm_p_area, sum,
lsm_c_ca

Examples

lsm_l_ta(landscape)
#> # A tibble: 1 × 6
#>   layer level     class    id metric value
#>   <int> <chr>     <int> <int> <chr>  <dbl>
#> 1     1 landscape    NA    NA ta      0.09