The sabre (Spatial Association Between REgionalizations) is an R package for calculating a degree of spatial association between regionalizations or categorical maps. This package offers support for
stars spatial objects, and the following methods:
You can install the released version of
sabre from CRAN with:
You can install the development version from GitHub with:
# install.packages("devtools") devtools::install_github("Nowosad/sabre")
We use two simple regionalization,
regions2 to show the basic concept of calculating a degree of spatial association.
The first map,
regions1 consists of four regions of the same shape and size, while the second one,
regions2 has three irregular regions.
vmeasure_calc() function allows for calculation of a degree of spatial association between regionalizations or categorical maps using the information-theoretical V-measure. It requires, at least, four arguments:
sfobject containing the first regionalization
x_name- a name of the column with regions names of the first regionalization
sfobject containing the second regionalization
y_name- a name of the column with regions names of the second regionalization
regions_vm = vmeasure_calc(x = regions1, y = regions2, x_name = z, y_name = z)
The result is a list with three metrics of spatial association -
Completeness - and two
sf objects with preprocessed input maps -
regions_vm #> The SABRE results: #> #> V-measure: 0.36 #> Homogeneity: 0.32 #> Completeness: 0.42 #> #> The spatial objects can be retrieved with: #> $map1 - the first map #> $map2 - the second map
Both spatial outputs have two columns. The first one contains regions’ names/values and the second one (
rih) describes regions’ inhomogeneities.
Additionally, examples presented in the Spatial association between regionalizations using the information-theoretical V-measure article can be reproduced using data available at http://sil.uc.edu/index.php?id=data-1#vmeasure.