Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free
Documentation
R
landscapemetrics

get_circumscribingcircle

get_circumscribingcircle

Description

Diameter of the circumscribing circle around patches

Usage

get_circumscribingcircle(landscape, directions, level)

## S3 method for class 'RasterLayer'
get_circumscribingcircle(landscape, directions = 8, level = "patch")

## S3 method for class 'RasterStack'
get_circumscribingcircle(landscape, directions = 8, level = "patch")

## S3 method for class 'RasterBrick'
get_circumscribingcircle(landscape, directions = 8, level = "patch")

## S3 method for class 'stars'
get_circumscribingcircle(landscape, directions = 8, level = "patch")

## S3 method for class 'list'
get_circumscribingcircle(landscape, directions = 8, level = "patch")

Arguments

landscape

RasterLayer or matrix (with x, y, id columns)
directions

The number of directions in which patches should be connected: 4 (rook's case) or 8 (queen's case).
level

Either 'patch' or 'class' for the corresponding level.

Details

The diameter of the smallest circumscribing circle around a patch in the landscape is based on the maximum distance between the corners of each cell. This ensures that all cells of the patch are included in the patch.

References

Based on C++ code from Project Nayuki (https://www.nayuki.io/page/smallest-enclosing-circle).

Examples

# get circle around each patch
get_circumscribingcircle(landscape)

# get circle around whole class
get_circumscribingcircle(landscape, level = "class")
landscapemetrics

Landscape Metrics for Categorical Map Patterns

v1.5.2
GPL-3
Authors
Maximillian H.K. Hesselbarth [aut, cre] (<https://orcid.org/0000-0003-1125-9918>), Marco Sciaini [aut] (<https://orcid.org/0000-0002-3042-5435>), Jakub Nowosad [aut] (<https://orcid.org/0000-0002-1057-3721>), Sebastian Hanss [aut] (<https://orcid.org/0000-0002-3990-4897>), Laura J. Graham [ctb] (Input on package structure), Jeffrey Hollister [ctb] (Input on package structure), Kimberly A. With [ctb] (Input on package structure), Florian Privé [ctb] (Original author of underlying C++ code for get_nearestneighbour() function), Project Nayuki [ctb] (Original author of underlying C++ code for get_circumscribingcircle and lsm_p_circle), Matt Strimas-Mackey [ctb] (Bugfix in sample_metrics())
Initial release

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.