BIEN_occurrence_family: Extract species occurrences by family.

In BIEN: Tools for Accessing the Botanical Information and Ecology Network Database

Extract species occurrences by family.

Description

BIEN_occurrence_family extracts all occurrences for a given family (or families) from the BIEN database.

Usage

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

Arguments

family	A single family or a vector of families.
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.
observation.type	Return information on type of observation (i.e. specimen vs. plot)? The default value is FALSE.
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.
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.

Value

Dataframe containing occurrence records for the specified family/families.

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

See Also

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

Examples

## Not run: 
BIEN_occurrence_family("Theaceae")
family_vector<-c("Theaceae","Ericaceae")
BIEN_occurrence_family(family_vector)
## End(Not run)

BIEN documentation built on April 3, 2025, 9:22 p.m.