BIEN_occurrence_species function

Extract occurrence data for specified species from BIEN

BIEN_occurrence_species downloads occurrence records for specific species from the BIEN database.

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

Arguments

• species: A single species, or a vector of species. Genus and species should be separated by a space. Genus should be capitalized.
• 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.
• only.geovalid: Should the returned records be limited to those with validated coordinates? Default is TRUE
• ...: Additional arguments passed to internal functions.

Returns

Dataframe containing occurrence records for the specified species.

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:

BIEN_occurrence_species("Abies amabilis")
species_vector<-c("Abies amabilis", "Acer nigrum")
BIEN_occurrence_species(species_vector)
BIEN_occurrence_species(species_vector,all.taxonomy = TRUE)
## 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_sf(), BIEN_occurrence_state()