plotDispersionField {epm}

Plot dispersion fields

Description

For a set of specified coordinates, plot a richness map for the species that are found at those coordinates.

Usage

plotDispersionField(
  x,
  coords,
  plotCoords = TRUE,
  legend = TRUE,
  col,
  lwd = 0.5,
  basemap = "worldmap",
  borderCol = "black",
  alpha = 1,
  includeFrame = FALSE,
  use_tmap = TRUE,
  add = FALSE
)

Arguments

x

object of class epmGrid

coords

coordinates as either a spatial points object (sp or sf), a matrix/dataframe with two columns or a numeric vector of c(long, lat).

plotCoords

boolean; should the coordinates be plotted as well?

legend

boolean; should legend be included?

col

either a vector of color names that will be interpolated, or a color ramp function that takes an integer (see for example colorRampPalette).

lwd

grid cell border width

basemap

if 'none', then only the grid is plotted. If 'worldmap', then vector map is plotted. If 'interactive', then the mapview package is used.

borderCol

color for grid cell borders

alpha

opacity of all colors and borders, ranging from 0 (fully transparent) to 1 (fully opaque)

includeFrame

boolean; include frame around plot?

use_tmap

boolean; if FALSE, plotting will be done via sf instead of tmap package

add

logical, add to existing plot?

Details

Assemblage dispersion fields represent an overlapping of geographic ranges for the taxa that occur in the focal grid cells.

Value

Nothing is returned.

Author(s)

Pascal Title

References

Graves, G. R., & Rahbek, C. (2005). Source pool geometry and the assembly of continental avifaunas. Proceedings of the National Academy of Sciences, 102(22), 7871–7876.

Examples

# plotDispersionField(tamiasEPM, c(-1944951, 69588.74))
plotDispersionField(tamiasEPM, c(-1944951, 69588.74), use_tmap = FALSE)