state_bad_neighbor_query: state_bad_neighbor_list

In usgs-bis/bad-neighbor-invasives: Bad Neighbor Analysis Package

Description

The primary BISON query and parsing function to develop both the state and buffer state lists of non-native species.

Usage

state_bad_neighbor_query(fips_list, taxon, state_name,
  useEstMeans = TRUE, get_buffer_fips = FALSE)

Arguments

fips_list	a single state two-digit FIPS code or a parenthetical group of FIPS codes. Pairs of state FIPS codes and surrounding states are pre-developed and stored in 'data/state_lookup.csv'. Note: the list includes the Distict of Columbia;
taxon	A string hierarchy_homonym_string in the form: "*\-179913\-*". Predefined lists are stored in: 'data/heirarchy_strings.csv'. The list of taxa is currently restricted to the best represented taxa in BISON.
state_name	(Optional) string name of the state to process.
useEstMeans	(Optional) flag to use the non-native flag in BISON. Defaults to TRUE.
get_buffer_fips	(Optional) flag to lookup the buffer states FIPS codes

Value

a tibble. A data frame with a list of bad neighbor species with associated TSN.

Examples

# look up all non-native plants in Virginia
va_nn <- state_bad_neighbor_query(fips_list = 51, taxon = "*\\-202422\\-*")

# same query using state name
va_nn <- state_bad_neighbor_query(state_name = "Virginia", taxon = "*\\-202422\\-*")

# all non-native plants in the surrounding buffer states 
buff_states <- "(24 11 37 47 21 54)"
buff_nn <- state_bad_neighbor_query(fips_list = buff_states, taxon = "*\\-202422\\-*")

# same query using state name and optional flag
buff_nn <- state_bad_neighbor_query(state_name = "Virginia", taxon = "*\\-202422\\-*", get_buffer_fips = TRUE)

usgs-bis/bad-neighbor-invasives documentation built on Sept. 26, 2019, 7:34 a.m.