The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.
rglobi
allows easy access to the GLoBI database by wrapping the existing API.
rglobi
install.packages("devtools")
##
## The downloaded binary packages are in
## /var/folders/v4/0_y78_xj1x7b72l89cwc2kq80000gp/T//RtmpF6qc1T/downloaded_packages
devtools::install_github("ropensci/rglobi")
## Downloading github repo ropensci/rglobi@master
## Installing rglobi
## '/Library/Frameworks/R.framework/Resources/bin/R' --vanilla CMD INSTALL \
## '/private/var/folders/v4/0_y78_xj1x7b72l89cwc2kq80000gp/T/RtmpF6qc1T/devtools15b730380a08/ropensci-rglobi-0b49250' \
## --library='/Library/Frameworks/R.framework/Versions/3.1/Resources/library' \
## --install-tests
##
## Reloading installed rglobi
library("rglobi")
Note that since rglobi is still pretty new, only the dev version of the library is available at this time. We hope to publish a version to CRAN once the library matures. For more information see GitHub.
Determining which species interact with each other (and how and where) is a major focus of ecology. The Global Biotic Interactions Database offers data on multiple interaction types, and the rglobi
library offers several ways to specify and access these interactions. get_interactions()
is the primary function used if data on a specific interaction type is required. A focus taxon is entered (may be specified as “Genus species” or higher level (e.g., Genus, Family, Class)).
hsapiens <- get_interactions(taxon = "Homo sapiens", interaction.type = "preysOn")
head(hsapiens)
## source_taxon_external_id source_taxon_name
## 1 EOL:327955 Homo sapiens
## 2 EOL:327955 Homo sapiens
## 3 EOL:327955 Homo sapiens
## 4 EOL:327955 Homo sapiens
## 5 EOL:327955 Homo sapiens
## 6 EOL:327955 Homo sapiens
## source_taxon_path
## 1 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## 2 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## 3 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## 4 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## 5 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## 6 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## source_specimen_life_stage interaction_type target_taxon_external_id
## 1 NA preysOn EOL:328048
## 2 NA preysOn EOL:328716
## 3 NA preysOn EOL:1666
## 4 NA preysOn EOL:326518
## 5 NA preysOn EOL:4453589
## 6 NA preysOn EOL:2815988
## target_taxon_name
## 1 Nandinia binotata
## 2 Cephalophus monticola
## 3 Manidae
## 4 Atherurus africanus
## 5 Cercopithecus nictitans nictitans
## 6 Serpentes
## target_taxon_path
## 1 Animalia | Chordata | Mammalia | Carnivora | Nandiniidae | Nandinia | Nandinia binotata
## 2 Animalia | Chordata | Mammalia | Artiodactyla | Bovidae | Cephalophus | Cephalophus monticola
## 3 Animalia | Chordata | Mammalia | Pholidota | Manidae
## 4 Animalia | Chordata | Mammalia | Rodentia | Hystricidae | Atherurus | Atherurus africanus
## 5 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Cercopithecoidea | Cercopithecidae | Cercopithecinae | Cercopithecini | Cercopithecus | Cercopithecus nictitans | Cercopithecus nictitans nictitans
## 6 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Reptilia | Squamata | Serpentes
## target_specimen_life_stage latitude longitude study_title
## 1 NA NA NA NA
## 2 NA NA NA NA
## 3 NA NA NA NA
## 4 NA NA NA NA
## 5 NA NA NA NA
## 6 NA NA NA NA
get_predators_of()
and get_prey_of()
are wrappers for get_interactions()
that remove the need to specify interaction type
hsapiens <- get_prey_of("Homo sapiens")
head(hsapiens)
## source_taxon_external_id source_taxon_name
## 1 EOL:327955 Homo sapiens
## 2 EOL:327955 Homo sapiens
## 3 EOL:327955 Homo sapiens
## 4 EOL:327955 Homo sapiens
## 5 EOL:327955 Homo sapiens
## 6 EOL:327955 Homo sapiens
## source_taxon_path
## 1 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## 2 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## 3 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## 4 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## 5 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## 6 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Hominoidea | Hominidae | Homininae | Homo | Homo sapiens
## source_specimen_life_stage interaction_type target_taxon_external_id
## 1 NA preysOn EOL:328048
## 2 NA preysOn EOL:328716
## 3 NA preysOn EOL:1666
## 4 NA preysOn EOL:326518
## 5 NA preysOn EOL:4453589
## 6 NA preysOn EOL:2815988
## target_taxon_name
## 1 Nandinia binotata
## 2 Cephalophus monticola
## 3 Manidae
## 4 Atherurus africanus
## 5 Cercopithecus nictitans nictitans
## 6 Serpentes
## target_taxon_path
## 1 Animalia | Chordata | Mammalia | Carnivora | Nandiniidae | Nandinia | Nandinia binotata
## 2 Animalia | Chordata | Mammalia | Artiodactyla | Bovidae | Cephalophus | Cephalophus monticola
## 3 Animalia | Chordata | Mammalia | Pholidota | Manidae
## 4 Animalia | Chordata | Mammalia | Rodentia | Hystricidae | Atherurus | Atherurus africanus
## 5 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Primates | Haplorrhini | Simiiformes | Cercopithecoidea | Cercopithecidae | Cercopithecinae | Cercopithecini | Cercopithecus | Cercopithecus nictitans | Cercopithecus nictitans nictitans
## 6 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Reptilia | Squamata | Serpentes
## target_specimen_life_stage latitude longitude study_title
## 1 NA NA NA NA
## 2 NA NA NA NA
## 3 NA NA NA NA
## 4 NA NA NA NA
## 5 NA NA NA NA
## 6 NA NA NA NA
For a complete list of supported interaction types,
get_interaction_types()
## interaction source target
## 1 preysOn predator prey
## 2 preyedUponBy prey predator
## 3 parasiteOf parasite host
## 4 hasParasite host parasite
## 5 pollinates pollinator plant
## 6 pollinatedBy plant pollinator
## 7 pathogenOf pathogen host
## 8 hasPathogen plant pollinator
## 9 symbiontOf source target
## 10 interactsWith source target
For data sources in which type of interactions was not specified, the interaction is labeled “interacts_with”.
If you wish to view all interactions instead of specific types (e.g., parasitism and predation instead of just one of the two), the get_interactions_by_taxa()
function allows this. In addition, the function provides options to search for interactions between two groups (source and target taxa, see above table) and only find interactions in a certain region.
rattus <- get_interactions_by_taxa(sourcetaxon = "Rattus")
head(rattus)
## source_taxon_external_id source_taxon_name
## 1 EOL:328447 Rattus rattus
## 2 EOL:328447 Rattus rattus
## 3 EOL:328447 Rattus rattus
## 4 EOL:328447 Rattus rattus
## 5 EOL:328447 Rattus rattus
## 6 EOL:328447 Rattus rattus
## source_taxon_path
## 1 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Rodentia | Myomorpha | Muridae | Murinae | Rattus | Rattus rattus
## 2 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Rodentia | Myomorpha | Muridae | Murinae | Rattus | Rattus rattus
## 3 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Rodentia | Myomorpha | Muridae | Murinae | Rattus | Rattus rattus
## 4 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Rodentia | Myomorpha | Muridae | Murinae | Rattus | Rattus rattus
## 5 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Rodentia | Myomorpha | Muridae | Murinae | Rattus | Rattus rattus
## 6 Animalia | Bilateria | Deuterostomia | Chordata | Vertebrata | Gnathostomata | Tetrapoda | Mammalia | Theria | Eutheria | Rodentia | Myomorpha | Muridae | Murinae | Rattus | Rattus rattus
## source_specimen_life_stage interaction_type target_taxon_external_id
## 1 NA interactsWith EOL:13340393
## 2 NA interactsWith EOL:10702710
## 3 NA interactsWith EOL:5004474
## 4 NA interactsWith EOL:4968671
## 5 NA interactsWith EOL:4965412
## 6 NA interactsWith EOL:4963889
## target_taxon_name
## 1 Mastophorus muris
## 2 Trypanosoma lewisi
## 3 Calodium hepaticum
## 4 Raillietina
## 5 Nippostrongylus brasiliensis
## 6 Syphacia
## target_taxon_path
## 1 Animalia | Nematoda | Secernentea | Spirurida | Spiruridae | Mastophorus | Mastophorus muris
## 2 Cellular organisms | Eukaryota | Euglenozoa | Kinetoplastida | Trypanosomatidae | Trypanosoma | Herpetosoma | Trypanosoma lewisi
## 3 Calodium hepaticum
## 4 Animalia | Platyhelminthes | Cestoda | Cyclophyllidea | Davaineidae | Raillietina
## 5 Animalia | Nematoda | Secernentea | Strongylida | Heligosomidae | Nippostrongylus | Nippostrongylus brasiliensis
## 6 Animalia | Nematoda | Secernentea | Ascaridida | Oxyuridae | Syphacia
## target_specimen_life_stage latitude longitude study_title
## 1 NA NA NA NA
## 2 NA NA NA NA
## 3 NA NA NA NA
## 4 NA NA NA NA
## 5 NA NA NA NA
## 6 NA NA NA NA
Only a source taxa need be identified, but you can also specify a target taxon and/or geographic boundary (Coordinates must be in decimal degrees (EPSG:4326) and correspond to the west, south, east, and northern boundaries (i.e., min x, min y, max x, max y).
aves_crustacea_northern_hemisphere <- get_interactions_by_taxa( sourcetaxon = "Aves", targettaxon = "Crustacea", bbox=c(-180, 0, 180, 90 ))
head(aves_crustacea_northern_hemisphere)
## source_taxon_external_id source_taxon_name
## 1 EOL:18884 Cepphus
## 2 EOL:1047918 Anas platyrhynchos
## 3 EOL:1049560 Recurvirostra americana
## 4 EOL:1049376 Arenaria melanocephala
## 5 EOL:1048977 Bucephala albeola
## 6 EOL:1048977 Bucephala albeola
## source_taxon_path
## 1 Animalia | Chordata | Aves | Charadriiformes | Alcidae | Cepphus
## 2 Animalia | Chordata | Aves | Anseriformes | Anatidae | Anas | Anas platyrhynchos
## 3 Animalia | Chordata | Aves | Charadriiformes | Recurvirostridae | Recurvirostra | Recurvirostra americana
## 4 Animalia | Chordata | Aves | Charadriiformes | Scolopacidae | Arenaria | Arenaria melanocephala
## 5 Animalia | Chordata | Aves | Anseriformes | Anatidae | Bucephala | Bucephala albeola
## 6 Animalia | Chordata | Aves | Anseriformes | Anatidae | Bucephala | Bucephala albeola
## source_specimen_life_stage interaction_type target_taxon_external_id
## 1 NA preysOn EOL:2625033
## 2 NA preysOn EOL:2620777
## 3 NA interactsWith EOL:2625033
## 4 NA preysOn EOL:2620777
## 5 NA interactsWith EOL:2625033
## 6 NA preysOn EOL:2620777
## target_taxon_name
## 1 Copepoda
## 2 Gammaridea
## 3 Copepoda
## 4 Gammaridea
## 5 Copepoda
## 6 Gammaridea
## target_taxon_path
## 1 Animalia | Bilateria | Protostomia | Ecdysozoa | Arthropoda | Crustacea | Maxillopoda | Copepoda
## 2 Animalia | Bilateria | Protostomia | Ecdysozoa | Arthropoda | Crustacea | Malacostraca | Eumalacostraca | Peracarida | Amphipoda | Gammaridea
## 3 Animalia | Bilateria | Protostomia | Ecdysozoa | Arthropoda | Crustacea | Maxillopoda | Copepoda
## 4 Animalia | Bilateria | Protostomia | Ecdysozoa | Arthropoda | Crustacea | Malacostraca | Eumalacostraca | Peracarida | Amphipoda | Gammaridea
## 5 Animalia | Bilateria | Protostomia | Ecdysozoa | Arthropoda | Crustacea | Maxillopoda | Copepoda
## 6 Animalia | Bilateria | Protostomia | Ecdysozoa | Arthropoda | Crustacea | Malacostraca | Eumalacostraca | Peracarida | Amphipoda | Gammaridea
## target_specimen_life_stage latitude longitude study_title
## 1 NA NA NA NA
## 2 NA NA NA NA
## 3 NA NA NA NA
## 4 NA NA NA NA
## 5 NA NA NA NA
## 6 NA NA NA NA
Instead of a taxon-specific approach, users may also wish to gather information on all interactions occuring in a specific area. For example, a group developing ecoystem models for the Gulf of Mexico may want to consider all the data from that region. rglobi
enables this type of search by allowing users to specify a rectangular bounding box. Coordinates must be in decimal degrees (EPSG:4326) and correspond to the west, south, east, and northern boundaries (i.e., min x, min y, max x, max y).
gulfinteractions <- get_interactions_in_area( bbox=c(-97.0, 17.5, -81, 31))
head(gulfinteractions)
## source_taxon_external_id source_taxon_name
## 1 EOL:1 Animalia
## 2 EOL:1905 Actinopterygii
## 3 EOL:2598871 Crustacea
## 4 EOL:208553 Chloroscombrus chrysurus
## 5 EOL:208553 Chloroscombrus chrysurus
## 6 EOL:208553 Chloroscombrus chrysurus
## source_taxon_path
## 1 Animalia
## 2 Biota | Animalia | Chordata | Vertebrata | Gnathostomata | Pisces | Actinopterygii
## 3 Animalia | Bilateria | Protostomia | Ecdysozoa | Arthropoda | Crustacea
## 4 Animalia | Chordata | Actinopterygii | Perciformes | Carangidae | Chloroscombrus | Chloroscombrus chrysurus
## 5 Animalia | Chordata | Actinopterygii | Perciformes | Carangidae | Chloroscombrus | Chloroscombrus chrysurus
## 6 Animalia | Chordata | Actinopterygii | Perciformes | Carangidae | Chloroscombrus | Chloroscombrus chrysurus
## source_specimen_life_stage interaction_type target_taxon_external_id
## 1 NA preyedUponBy EOL:208553
## 2 NA preyedUponBy EOL:208553
## 3 NA preyedUponBy EOL:208553
## 4 NA preysOn EOL:1
## 5 NA preysOn EOL:1905
## 6 NA preysOn EOL:2598871
## target_taxon_name
## 1 Chloroscombrus chrysurus
## 2 Chloroscombrus chrysurus
## 3 Chloroscombrus chrysurus
## 4 Animalia
## 5 Actinopterygii
## 6 Crustacea
## target_taxon_path
## 1 Animalia | Chordata | Actinopterygii | Perciformes | Carangidae | Chloroscombrus | Chloroscombrus chrysurus
## 2 Animalia | Chordata | Actinopterygii | Perciformes | Carangidae | Chloroscombrus | Chloroscombrus chrysurus
## 3 Animalia | Chordata | Actinopterygii | Perciformes | Carangidae | Chloroscombrus | Chloroscombrus chrysurus
## 4 Animalia
## 5 Biota | Animalia | Chordata | Vertebrata | Gnathostomata | Pisces | Actinopterygii
## 6 Animalia | Bilateria | Protostomia | Ecdysozoa | Arthropoda | Crustacea
## target_specimen_life_stage latitude longitude study_title
## 1 NA NA NA NA
## 2 NA NA NA NA
## 3 NA NA NA NA
## 4 NA NA NA NA
## 5 NA NA NA NA
## 6 NA NA NA NA
To see all locations for which interactions have entered in GloBi,
areas <- get_interaction_areas()
head(areas)
## Latitude Longitude
## 1 29.34695 -92.98061
## 2 29.03260 -92.28701
## 3 28.03673 -96.11108
## 4 27.62409 -95.77403
## 5 26.33146 -96.03294
## 6 30.25024 -86.13114
You can also restrict this search to a certain area:
areas <- get_interaction_areas (bbox=c(-67.87,12.79,-57.08,23.32))
head(areas)
## Latitude Longitude
## 1251 18.24829 -66.49989
## 1255 18.33884 -65.82572
## 1268 18.06667 -63.06667
## 1339 13.16667 -59.53333
These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.