OpenRange_species {OpenRange} | R Documentation |
Download range maps for given species.
Description
OpenRange_species extracts range maps for the specified species.
Usage
OpenRange_species(
species,
directory,
default_only = TRUE,
matched = TRUE,
match_names_only = FALSE,
include_id = TRUE,
projection = 4326,
scenario = "present",
...
)
Arguments
species |
A single species or a vector of species. |
directory |
Directory that range maps should be saved in. |
default_only |
Logical. Should only default ranges be included? Default is TRUE. |
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_id |
Logical. Should the range_id be appended to the file name? Needed to save multiple maps per species. |
projection |
Numeric. What projection should maps be returned in? 4326 (default) or 3857 |
scenario |
Which climate scenario should be represented by maps? See BIEN_ranges_list_scenarios. |
... |
Additional arguments passed to internal functions. |
Value
Range maps for specified species.
Note
Details on the construction of BIEN range maps is available at http://bien.nceas.ucsb.edu/bien/biendata/bien-3/
See Also
Other range functions:
OpenRange_api_load_species()
,
OpenRange_api_species()
,
OpenRange_get_license()
,
OpenRange_get_stats()
,
OpenRange_list_scenarios()
,
OpenRange_load_species()
,
OpenRange_sf()
Examples
library(maps) #a convenient source of maps
library(sf)
species_vector <- c("Abies_lasiocarpa","Abies_amabilis")
#check whether the species are available
OpenRange_species(species_vector,match_names_only = TRUE)
#Create a temp directory
temp_dir <- file.path(tempdir(), "BIEN_temp")
#Download ranges
OpenRange_species(species = species_vector,
directory = temp_dir)#saves ranges to a temporary directory
#Reading files
Abies_poly <- st_read(dsn = temp_dir,
layer = "Abies_amabilis_117684")
#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,col="forest green",add=TRUE) #adds the range of Abies lasiocarpa to the map
#Getting data from the files
Abies_poly |>
st_drop_geometry()