get_interactions_by_taxa: Return interactions involving specific taxa

In ropensci/rglobi: Interface to Global Biotic Interactions

Return interactions involving specific taxa

Description

Returns interactions involving specific taxa. Secondary (target) taxa and spatial boundaries may also be set

Usage

get_interactions_by_taxa(
  sourcetaxon,
  targettaxon = NULL,
  interactiontype = NULL,
  accordingto = NULL,
  showfield = c("source_taxon_external_id", "source_taxon_name", "source_taxon_path",
    "source_specimen_life_stage", "interaction_type", "target_taxon_external_id",
    "target_taxon_name", "target_taxon_path", "target_specimen_life_stage", "latitude",
    "longitude", "study_citation", "study_external_id", "study_source_citation"),
  otherkeys = NULL,
  bbox = NULL,
  returnobservations = FALSE,
  opts = list(),
  read_csv = read_csv_online
)

Arguments

sourcetaxon	Taxa of interest (consumer, predator, parasite); may be specified as "Genus species" or higher level (e.g., Genus, Family, Class).
targettaxon	Taxa of interest (prey, host); may be specified as "Genus species" or higher level (e.g., Genus, Family, Class)
interactiontype	Interaction types of interest (prey, host); may be specified as listed by get_interaction_types()
accordingto	Data source of interest
showfield	Data fields of interest (e. g. source_taxon_external_id, source_taxon_name); may be specified as listed by get_data_fields()
otherkeys	list of key-value pairs to query any field not covered by other parameters; keys may be specified as listed by get_data_fields()
bbox	Coordinates in EPSG:4326 decimal degrees defining "left, bottom, right, top" of bounding box
returnobservations	if true, all individual observations are returned, else only distinct relationships
opts	list of named options to configure GloBI API
read_csv	function used to find csv associated to query url, defaulting to online query method

Value

Returns data frame of interactions

Note

For data sources in which type of interactions were not specified, the interaction is labeled "interacts_with"

See Also

Other interactions: get_interaction_matrix(), get_interaction_types(), get_interactions_by_type(), get_interactions(), get_predators_of(), get_prey_of()

Examples

get_interactions_by_taxa(sourcetaxon = "Rattus")
get_interactions_by_taxa(sourcetaxon = "Aves", targettaxon = "Rattus")
get_interactions_by_taxa(sourcetaxon = "Rattus rattus",
bbox = c(-67.87,12.79,-57.08,23.32))

ropensci/rglobi documentation built on Feb. 12, 2025, 2:06 a.m.