Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

robis

Build and maintain a global alliance that collaborates with scientific communities to facilitate free and open access to, and application of, biodiversity and biogeographic data and information on marine life.
https://github.com/iobis/robis

Category: Biosphere
Sub Category: Biodiversity Data Access and Management

Last synced: about 23 hours ago
JSON representation

Repository metadata

R client for the OBIS API

README.md

robis: an R client for the OBIS API

DOI

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:

  • Download data from OBIS
  • Create a checklist of taxa that met a set of filters
  • Download measurements and facts associated with occurrences
  • Create maps from occurrences (including leaflet maps)

Installation

robis is available from CRAN.

# CRAN
install.packages("robis")

# latest development version
remotes::install_github("iobis/robis")

Getting started

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:

map_leaflet(records)

Or you can create a ggplot map using:

map_ggplot(records)

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.

Spatial Filtering

There are a variety of ways to add a spatial filter to your query:

  1. Filter by geography using 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 corresponding id values can be used in the areaid parameter of the occurrence and checklist functions.

  1. Filter with Well-Known Text (WKT) strings.

Both the occurrence and checklist functions allow spatial filtering with Well-Known Text (WK) strings, via the geometry 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 function get_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 object wkt. If you aren't happy with what you've drawn, you can click the trashcan icon to clear the shape from the tool.

How to use OBIS data

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.

obistools package

There is a companion package, obistools, available from GitHub: github.com/iobis/obistools

obistools provide several tools for cleaning data downloaded from OBIS, like:

  • Checking points on land
  • Checking depths
  • Checking dates

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 10 days ago

Total Commits: 214
Total Committers: 6
Avg Commits per committer: 35.667
Development Distribution Score (DDS): 0.266

Commits in past year: 10
Committers in past year: 2
Avg Commits per committer in past year: 5.0
Development Distribution Score (DDS) in past year: 0.1

Name Email Commits
Pieter Provoost p****t@g****m 157
Samuel Bosch m****l@s****m 44
sformel s****e@f****m 9
silasprincipe 5****e 2
Ben Best b****t 1
ironholds i****s@g****m 1

Committer domains:

Issue and Pull Request metadata

Last synced: 4 months ago

Total issues: 85
Total pull requests: 9
Average time to close issues: over 1 year
Average time to close pull requests: 3 months
Total issue authors: 28
Total pull request authors: 6
Average comments per issue: 1.38
Average comments per pull request: 2.0
Merged pull request: 8
Bot issues: 0
Bot pull requests: 0

Past year issues: 2
Past year pull requests: 3
Past year average time to close issues: N/A
Past year average time to close pull requests: 9 days
Past year issue authors: 1
Past year pull request authors: 1
Past year average comments per issue: 0.0
Past year average comments per pull request: 4.67
Past year merged pull request: 3
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/iobis/robis

Top Issue Authors

  • pieterprovoost (34)
  • samuelbosch (8)
  • ekleins (7)
  • sckott (4)
  • wardappeltans (3)
  • haniehsaeedi (2)
  • sformel (2)
  • goldsoundz80 (2)
  • tomjwebb (2)
  • jebyrnes (2)
  • 7yl4r (2)
  • miriamgrace (1)
  • sformel-usgs (1)
  • diodon (1)
  • Enchufa2 (1)

Top Pull Request Authors

  • sformel (4)
  • samuelbosch (2)
  • bbest (1)
  • roliveros-ramos (1)
  • silasprincipe (1)
  • Ironholds (1)

Top Issue Labels

  • bug (14)
  • enhancement (6)
  • documentation (4)
  • feature (3)
  • invalid (2)
  • question (1)

Top Pull Request Labels

Package metadata

cran.r-project.org: robis

Ocean Biodiversity Information System (OBIS) Client

  • Homepage: https://github.com/iobis/robis
  • Documentation: http://cran.r-project.org/web/packages/robis/robis.pdf
  • Licenses: MIT + file LICENSE
  • Latest release: 2.11.3 (published over 3 years ago)
  • Last Synced: 2025-12-19T09:39:33.441Z (6 days ago)
  • Versions: 11
  • Dependent Packages: 0
  • Dependent Repositories: 6
  • Downloads: 2,414 Last month
  • Rankings:
    • Forks count: 6.338%
    • Stargazers count: 9.598%
    • Dependent repos count: 12.1%
    • Average: 14.668%
    • Downloads: 17.453%
    • Dependent packages count: 27.852%
  • Maintainers (1)
conda-forge.org: r-robis

  • Homepage: https://github.com/iobis/robis
  • Licenses: MIT
  • Latest release: 2.11.3 (published over 3 years ago)
  • Last Synced: 2025-12-01T10:01:57.231Z (24 days ago)
  • Versions: 10
  • Dependent Packages: 0
  • Dependent Repositories: 3
  • Rankings:
    • Dependent repos count: 17.914%
    • Average: 40.286%
    • Forks count: 44.777%
    • Stargazers count: 46.913%
    • Dependent packages count: 51.54%

Dependencies

DESCRIPTION cran
  • R >= 3.1.3 depends
  • curl * imports
  • data.table * imports
  • dplyr * imports
  • ggplot2 * imports
  • glue * imports
  • httpcache * imports
  • httr * imports
  • jsonlite * imports
  • leaflet * imports
  • mapedit * imports
  • purrr * imports
  • rlang * imports
  • sf * imports
  • stringr * imports
  • tibble * imports
  • tidyr * imports
  • tidyselect * imports
  • xml2 * imports
  • knitr * suggests
  • rmarkdown * suggests
  • spelling * suggests
  • testthat * suggests

Score: 13.774588558443686