segmetric (version 0.3.0)

segmetric_functions: General functions

Description

These functions manipulate segmetric objects.

• sm_read(): Load the reference and segmentation polygons into segmetric.

• sm_clear(): Remove the already calculated metrics from segmetric.

• print(): Print a segmetric object.

• plot(): Plot the reference and segmentation polygons.

• summary(): Compute a measure of central tendency over the values of a metric.

• sm_is_empty(): Check if a segmetric object is empty.

Usage

.segmetric_check(m)
.segmetric_env(m)
sm_read(ref_sf, seg_sf)
sm_clear(m)
# S3 method for segmetric
summary(object, weight = NULL, na_rm = TRUE, ...)
sm_is_empty(m)
# S3 method for segmetric
[(x, i)

Value

• sm_read(), sm_clear(): Return a segmetric object containing an empty list and an environment attribute to store the necessary datasets.

• sm_is_empty(): Return a logical vector indicating if each computed metric is empty.

Arguments

m

A segmetric object.

ref_sf

A sf object. The reference polygons.

seg_sf

A sf object. The segmentation polygons.

object

A segmetric object.

weight

Weights to summarize metrics. Accepts character options "ref", "seg", and "inter", that weights using reference, segment, and intersection areas, respectively. Also accepts a numeric vector of weights of the same length as input metrics giving the weights to be used.

na_rm

Should missing values (including NaN) be removed?

...

Additional parameters (Not implemented).

See Also

sm_compute()

Examples

# load sample datasets
data("sample_ref_sf", package = "segmetric")
data("sample_seg_sf", package = "segmetric")

# create segmetric object
m <- sm_read(ref_sf = sample_ref_sf, seg_sf = sample_seg_sf)

# plot geometries
plot(m)

# compute a metric
sm_compute(m, "AFI")

# summarize the metric using mean
sm_compute(m, "AFI") %>% summary()

# clear computed subsets
sm_clear(m)