This function visualizes deployments features such as number of detected species, number of observations and RAI on a dynamic map. The circle size and color are proportional to the mapped feature. Deployments without observations are shown as gray circles and a message is returned.
map_dep( package = NULL, feature, ..., species = NULL, sex = NULL, life_stage = NULL, effort_unit = NULL, cluster = TRUE, hover_columns = c("n", "species", "deploymentID", "locationID", "locationName", "latitude", "longitude", "start", "end"), palette = "inferno", zero_values_show = TRUE, zero_values_icon_url = "https://img.icons8.com/ios-glyphs/30/000000/multiply.png", zero_values_icon_size = 10, relative_scale = TRUE, max_scale = NULL, radius_range = c(10, 50), datapkg = lifecycle::deprecated() )
Camera trap data package object, as returned by
Deployment feature to visualize. One of:
"n_species": number of identified species
"n_obs": number of observations
"n_individuals": number of individuals
"rai": Relative Abundance Index
"effort": effort (duration) of the deployment
Filter predicates for subsetting deployments.
Character with a scientific name. Required for
Character defining the sex class to filter on, e.g.
NULL, default, all observations of all sex classes are taken into
account. Optional argument for
Character vector defining the life stage class to filter on, e.g.
c("subadult", "adult"). If
NULL, default, all observations
of all life stage classes are taken into account. Optional argument for
Time unit to use while visualizing deployment effort (duration). One of:
Logical value indicating whether using the cluster option while visualizing maps. Default: TRUE.
Character vector with the name of the columns to use for
showing location deployment information while hovering the mouse over. One
or more from deployment columns. Use
NULL to disable hovering. Default
n: number of species, number of observations, RAI or effort (column
created internally by a
species: species name(s)
start: start deployment
end: end deployment -
deploymentID deployment unique identifier
locationID location unique identifier
locationName location name
See section Deployment of Camtrap DP standard for the full list of columns you can use.
The palette name or the color function that values will be mapped to. Typically one of the following:
A character vector of RGB or named colors. Examples:
c("#000000", "#0000FF", "#FFFFFF")),
the full name of a RColorBrewer palette, e.g. "BuPu" or "Greens", or
For more options, see argument
Logical indicating whether to show deployments with
zero values. Default:
character with URL to icon for showing
deployments with zero values. Default: a cross (multiply symbol)
a number to set the size of the icon to show deployments with wero values. Default: 10.
Logical indicating whether to use a relative color
and radius scale (
TRUE) or an absolute scale (
FALSE). If absolute scale
is used, specify a valid
Number indicating the max value used to map color and radius.
Vector of length 2 containing the lower and upper limit
of the circle radius. The lower value is used for deployments with zero
feature value, i.e. no observations, no identified species, zero RAI or
zero effort. The upper value is used for the deployment(s) with the highest
feature value (