BIEN_occurrence_sf function

Extract occurrence data for specified sf polygon

BIEN_occurrence_sf downloads occurrence records falling within a user-specified sf polygon

BIEN_occurrence_sf(
  sf,
  cultivated = FALSE,
  new.world = NULL,
  all.taxonomy = FALSE,
  native.status = FALSE,
  natives.only = TRUE,
  observation.type = FALSE,
  political.boundaries = FALSE,
  collection.info = FALSE,
  ...
)

Arguments

• sf: An object of class sf. Note that the projection must be WGS84.
• cultivated: Return known cultivated records as well? Default is FALSE.
• new.world: NULL (The default) returns global records, TRUE returns only New World, and FALSE only Old World.
• all.taxonomy: Return all taxonomic information? This includes the raw data as well as the "scrubbed" data.
• native.status: Return information on introduction status? The default value is FALSE. A value of TRUE also returns additional information on introduction status.
• natives.only: Exclude detected introduced species? Default is TRUE.
• observation.type: Return information on type of observation (i.e. specimen vs. plot)? The default value is FALSE.
• political.boundaries: Return information on political boundaries for an observation? The default value is FALSE.
• collection.info: Return additional information about collection and identification? The default value is FALSE.
• ...: Additional arguments passed to internal functions.

Returns

Dataframe containing occurrence records falling within the polygon.

Note

US FIA coordinates have been fuzzed and swapped, for more details see: https://www.fia.fs.fed.us/tools-data/spatial/Policy/index.php

Examples

## Not run:

library(sf)  

# first, we download an example shapefile to use (a species range)

BIEN_ranges_species("Carnegiea gigantea")#saves range to the current working directory

# load the range map as an sf object

sf <- st_read(dsn = ".",layer = "Carnegiea_gigantea")

# get the occurrences that occur within the polygon.

species_occurrences <- BIEN_occurrence_sf(sf = sf)
## End(Not run)

See Also

Other occurrence functions: BIEN_occurrence_box(), BIEN_occurrence_country(), BIEN_occurrence_county(), BIEN_occurrence_family(), BIEN_occurrence_genus(), BIEN_occurrence_records_per_species(), BIEN_occurrence_species(), BIEN_occurrence_state()