robis is an R package that allows accessing data from the Ocean Biodiversity Information System (OBIS) directly from R. OBIS is a global open-access data and information clearing-house on marine biodiversity for science, conservation and sustainable development.
With robis users can:
leaflet
maps)robis is available from CRAN.
# CRAN install.packages("robis") # latest development version remotes::install_github("iobis/robis")
The main functions of the robis package are occurrences
and checklist
. You can easily download data for one species using:
records <- occurrence(scientificname = "Abra sibogai")
Then you can plot the occurrences with:
Or you can create a ggplot
map using:
With the function checklist
it's possible to obtain a checklist of all taxa in OBIS that met a certain filter. For example, here we obtain all species from the family "Tellinidae"
taxa <- checklist(scientificname = "Tellinidae")
See the Getting started vignette for more details on how to download data according to filters and how to extract measurements or facts from occurrence data using the function measurements
.
There are a variety of ways to add a spatial filter to your query:
areaid
filters.OBIS provides polygon filters for about 800 areas of interest, like the Southern Ocean or the Bay of Bengal. These can be viewed via the
area
function. The correspondingid
values can be used in theareaid
parameter of theoccurrence
andchecklist
functions.
Both the
occurrence
andchecklist
functions allow spatial filtering with Well-Known Text (WK) strings, via thegeometry
parameter. Following this example from the OBIS Manual, here is an example of how to obtain a checklist of Mollusc species in a certain area:
mollcheck<-checklist(scientificname="Mollusca", geometry = "POLYGON ((2.3 51.8, 2.3 51.6, 2.6 51.6, 2.6 51.8, 2.3 51.8))")
If you're unsure how to construct WKT,
robis
includes the functionget_geometry
, which provides an interactive tool to draw shapes and return WKT than can be plugged into queries.
To use it, run:
wkt <- get_geometry()
. This will open up the tool in the Viewer of RStudio. You can zoom, pan, and use the shapes to draw on the map. Once you are satisfied with what you've drawn, click the 'Done' button in the bottom right hand corner, and it will assign the WKT to the objectwkt
. If you aren't happy with what you've drawn, you can click the trashcan icon to clear the shape from the tool.
OBIS holds a large collection of biodiversity information, with more than 100 million presence records and almost 200 measurements and facts. This information is powering research in areas like taxonomy, phylogeny and ecology, and is being used as an important tool in conservation and management. You can learn more about OBIS with the OBIS manual. You can also explore some of our use cases or the many publications that applied OBIS data.
There is a companion package, obistools, available from GitHub: github.com/iobis/obistools
obistools provide several tools for cleaning data downloaded from OBIS, like:
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4