wcvp_distribution: Generate spatial distribution objects for species, genera or...

In rWCVP: Generating Summaries, Reports and Plots from the World Checklist of Vascular Plants

Generate spatial distribution objects for species, genera or families

Description

Generate spatial distribution objects for species, genera or families

Usage

wcvp_distribution(
  taxon,
  taxon_rank = c("species", "genus", "family", "order", "higher"),
  native = TRUE,
  introduced = TRUE,
  extinct = TRUE,
  location_doubtful = TRUE,
  wcvp_names = NULL,
  wcvp_distributions = NULL
)

Arguments

taxon	Character. The taxon to be mapped. Must be provided.
taxon_rank	Character. One of "species", "genus", "family", "order" or "higher", giving the rank of the value in taxon.
native	Logical. Include native range? Defaults to TRUE.
introduced	Logical. Include introduced range? Defaults to TRUE.
extinct	Logical. Include extinct range? Defaults to TRUE.
location_doubtful	Logical. Include occurrences that are thought to be doubtful? Defaults to TRUE.
wcvp_names	A data frame of taxonomic names from WCVP version 7 or later. If NULL (the default), names will be loaded from rWCVPdata::wcvp_names.
wcvp_distributions	A data frame of distributions from WCVP version 7 or later. If NULL (the default), distributions will be loaded from rWCVPdata::wcvp_names.

Details

Where taxon_rank is higher than species, the distribution of the whole group will be returned, not individual species within that group. This also applies when toggling options - for example, introduced occurrences will only be included if they are outside the native range, regardless of whether native=TRUE or native=FALSE. To identify extinctions, introductions or doubtful occurrences within the native range, the wcvp_summary and wcvp_occ_mat functions can be used.

Value

Simple features (sf) data frame containing the range polygon/s of the taxon.

Examples

 # this example requires 'rWCVPdata'
if(requireNamespace("rWCVPdata")){
r <- wcvp_distribution("Callitris", taxon_rank = "genus")
p <- wcvp_distribution_map(r)
p
}

rWCVP documentation built on Feb. 16, 2023, 8:30 p.m.