BIEN_occurrence_county: Extract species occurrence records by county.

View source: R/BIEN.R

BIEN_occurrence_countyR Documentation

Extract species occurrence records by county.

Description

BIEN_occurrence_county extracts occurrences records for the specified county or counties.

Usage

BIEN_occurrence_county(
  country = NULL,
  state = NULL,
  county = NULL,
  country.code = NULL,
  state.code = NULL,
  county.code = NULL,
  cultivated = FALSE,
  new.world = NULL,
  all.taxonomy = FALSE,
  native.status = FALSE,
  natives.only = TRUE,
  observation.type = FALSE,
  political.boundaries = FALSE,
  collection.info = FALSE,
  ...
)

Arguments

country

A single country or vector of countries.

state

A state or vector of states (or other primary political divisions, e.g. provinces).

county

A single county or a vector of counties (or other secondary political division, e.g. parish).

country.code

A single country (or other primary administrative boundary) code or a vector of country codes equal in length to the vector of states/province codes.

state.code

A single state/province code, or a vector of states/province codes.

county.code

A single county (or other secondary administrative boundary) code or a vector of county codes equal in length to the vectors of states/province codes and country codes.

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.

Value

Dataframe containing occurrence records for the specified states/provinces.

Note

Political division (or political division code) spelling needs to be exact and case-sensitive, see BIEN_metadata_list_political_names for a list of political divisions and associated codes.

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

This function requires you supply either 1) a single country with one or more states, or 2) vectors of equal length for each political level.

See Also

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

Examples

## Not run: 
BIEN_occurrence_county("United States","Arizona","Pima")
country_vector<-c("United States","United States")
state_vector<-c("Arizona","Michigan")
county_vector<-c("Pima","Kent")
BIEN_occurrence_county(country=country_vector, state = state_vector, county = county_vector)
## End(Not run)

BIEN documentation built on Jan. 6, 2023, 9:06 a.m.