Built in plotting function for Kernel density Raster. — plot_forage

This function provides a simple way to produce consistent maps of Kernel density plots. Please be aware that the 'basemap', 'rivers' and 'add_hillshade' arguments use the following functions: rosm::osm.image() osmdata::opq() which occasional fail during busy server times.

Usage

plot_forage_density(
  kd_raster,
  basemap = TRUE,
  basemap_type = "osmgrayscale",
  trans_fill = TRUE,
  trans_type = "log10",
  axes_units = TRUE,
  scalebar = TRUE,
  scalebar_loc = "tl",
  north_arrow = TRUE,
  north_arrow_loc = "br",
  north_arrow_size = 0.75,
  wgs = TRUE,
  guide = TRUE,
  catchment = NULL,
  rivers = FALSE,
  add_hillshade = FALSE,
  plot_extent = NULL,
  attribute = TRUE,
  guide_width = NULL,
  mask_fill = "grey50"
)

Arguments

kd_raster: Kernel Density raster generated from the beavertools::forage_density()
basemap: Boolean, include an OSM basemap. (optional)
basemap_type: Character vector for osm map type. for options see rosm::osm.types()
trans_fill: Boolean to transform the colourmap - visualisation general better when TRUE (the default)
trans_type: Character vector for the type of transform.
axes_units: Boolean to include coordinate values on axis.
scalebar: Boolean to include a scalebar.
scalebar_loc: character vector for the scalebar location one of:'tl', 'bl', 'tr', 'br' Meaning "top left" etc.
north_arrow: Boolean to include a north arrow
north_arrow_loc: character vector for the arrow location one of:'tl', 'bl', 'tr', 'br' Meaning "top left" etc.
north_arrow_size: numeric vector for the arrow
wgs: Boolean to transform coordinate reference system (CRS) to WGS84 (EPSG:4326)
guide: Boolean to include a legend
catchment: An sf object or an sf-readable file. See sf::st_drivers() for available drivers. This feature should be a boundary such as a catchment or Area of interest. It is used to mask the map region outside of desired AOI.
rivers: Boolean to include river lines (downloaded automatcally using the osmdata package) OR a river network of class 'sf' which can be generated beforehand using beavertools::get_rivers().
add_hillshade: Boolean to add an osm hillshade background map. This can be combined with 'basemap_type' to create a textured basemap.
plot_extent: 'bbox', 'sf' or 'sp' object used to set the plot extent.
attribute: Boolean to include an open street map attribution.

Value

ggplot object of Kernel Density Map

Examples

# Here we filter the filter the built in 2019-2020 ROBT feeding sign data `RivOtter_FeedSigns`
# Then pipe this 'sf' object to forage_density.

ROBT_201920 <- RivOtter_FeedSigns %>%
dplyr::filter(SurveySeason == "2019 - 2020")%>%
  forage_density(., 'FeedCat')
#> No value supplied for "kd_extent" argument: default extent will be used
#> Error in spatialEco::sp.kde(forage_points, y = forage_points$weights,     bw = kern_bw, nr = dims$nrows[1], nc = dims$ncols[1], newdata = kd_extent,     standardize = standardise): unused arguments (nr = dims$nrows[1], nc = dims$ncols[1], newdata = kd_extent)

# Now we plot the raster with plot_forage_density
plot_forage_density(ROBT_201920, catchment = RivOtter_Catch_Area, rivers = TRUE,
                                     trans_fill=TRUE)
#> Error in eval(expr, envir, enclos): object 'ROBT_201920' not found