BIEN_ranges_species function

Download range maps for given species.

BIEN_ranges_species extracts range maps for the specified species.

BIEN_ranges_species(
  species,
  directory = NULL,
  matched = TRUE,
  match_names_only = FALSE,
  include.gid = FALSE,
  ...
)

Arguments

• species: A single species or a vector of species.
• directory: Directory that range maps should be saved in. If none is specified, range maps will be saved in the current working directory.
• matched: Return a list of taxa that were downloaded. Default is TRUE.
• match_names_only: Check for range maps for the taxa specified without downloading range maps. Default is FALSE.
• include.gid: Should the files returned have a unique GID appended to them? This is needed if downloading multiple maps for the same species.
• ...: Additional arguments passed to internal functions.

Returns

Range maps for specified species.

Note

Details on the construction of BIEN range maps is available at https://bien.nceas.ucsb.edu/bien/biendata/bien-3/

Examples

## Not run:

library(sf)
library(maps) #a convenient source of maps
species_vector <- c("Abies_lasiocarpa","Abies_amabilis")
BIEN_ranges_species(species_vector)
BIEN_ranges_species(species_vector, match_names_only = TRUE)
temp_dir <- file.path(tempdir(), "BIEN_temp")#Set a working directory
BIEN_ranges_species(species = species_vector,
                    directory = temp_dir)#saves ranges to a temporary directory
BIEN_ranges_species("Abies_lasiocarpa")
BIEN_ranges_species("Abies_lasiocarpa",
                    directory = temp_dir)

#Reading files

Abies_poly <- st_read(dsn = temp_dir,
                      layer = "Abies_lasiocarpa")

#Plotting files
plot(Abies_poly[1])#plots the range, but doesn't mean much without any reference
map('world', fill = TRUE, col = "grey")#plots a world map (WGS84 projection), in grey

plot(Abies_poly[1],
     col = "forest green",
     add = TRUE) #adds the range of Abies lasiocarpa to the map

# Getting data from the files (currently only species names and a BIEN ID field)
Abies_poly$species#gives the species name associated with "Abies_poly"
## End(Not run)
#'

See Also

Other range functions: BIEN_ranges_box(), BIEN_ranges_genus(), BIEN_ranges_intersect_species(), BIEN_ranges_list(), BIEN_ranges_load_species(), BIEN_ranges_sf(), BIEN_ranges_shapefile_to_skinny(), BIEN_ranges_skinny_ranges_to_richness_raster(), BIEN_ranges_species_bulk()