bioregion (version 1.3.0)

map_bioregions: Create a map of bioregions

Description

This plot function can be used to visualize bioregions based on a bioregion.clusters object combined with a geometry (sf objects).

Usage

map_bioregions(
  clusters,
  geometry,
  bioregionalization = NULL,
  write_clusters = FALSE,
  plot = TRUE,
  ...
)

Value

One or several maps of bioregions if plot = TRUE and the geometry with additional clusters' attributes if write_clusters = TRUE.

Arguments

clusters

An object of class bioregion.clusters or a data.frame. If a data.frame is used, the first column should represent the sites' ID, and the subsequent column(s) should represent the clusters.

geometry

A spatial object that can be handled by the sf package. The first attribute should correspond to the sites' ID (see Details).

bioregionalization

An integer, character, or NULL specifying which bioregionalization(s) to plot. If NULL (default), all bioregionalizations are plotted. If an integer or vector of integers, bioregionalization(s) are selected by column number(s) in the clusters data.frame (starting from 1 after the ID column). If a character or vector of characters, bioregionalization(s) are selected by name(s) matching column names in clusters.

write_clusters

A boolean indicating if the clusters should be added to the geometry.

plot

A boolean indicating if the plot should be drawn.

...

Further arguments to be passed to sf::plot().

Author

Maxime Lenormand ()
Boris Leroy ()
Pierre Denelle ()

Details

The clusters and geometry site IDs should correspond. They should have the same type (i.e., character if clusters is a bioregion.clusters object) and the sites of clusters should be included in the sites of geometry.

Bipartite networks: If the clusters object is from a bipartite network (containing both sites and species), only site nodes will be mapped. The function automatically filters to site nodes using the node_type attribute.

Colors: If the clusters object contains colors (added via bioregion_colors()), these colors will be automatically used for plotting. Otherwise, the default sf color scheme will be applied.

Examples

data(fishmat)
data(fishdf) # (data.frame version of fishmat)
data(fishsf)

net <- similarity(fishmat, metric = "Simpson")
clu <- netclu_greedy(net)
map <- map_bioregions(clu, fishsf, write_clusters = TRUE, plot = FALSE)

# With colors
clu_colored <- bioregion_colors(clu)
map_bioregions(clu_colored, fishsf, plot = TRUE)

# With bipartite network (sites and species)
clu_bip <- netclu_greedy(fishdf, bipartite = TRUE)
clu_bip_colored <- bioregion_colors(clu_bip)
map_bioregions(clu_bip_colored, fishsf, plot = TRUE)

# With multiple bioregionalizations, plot only specific ones
dissim <- dissimilarity(fishmat, metric = "Simpson")
clu_multi <- hclu_hierarclust(dissim,
                              optimal_tree_method = "best",
                              n_clust = c(2, 4, 10))
map_bioregions(clu_multi, fishsf, bioregionalization = c(1, 3),
 plot = TRUE)  # By index
map_bioregions(clu_multi, fishsf, bioregionalization = c("K_2", "K_4"), 
plot = TRUE)  # By name