Name: spocc
Owner: rOpenSci
Description: Species occurrence data toolkit for R
Created: 2013-09-05 16:46:13.0
Updated: 2018-01-03 10:06:54.0
Pushed: 2018-01-05 19:51:56.0
Homepage: https://ropensci.github.io/spocc/
Size: 3961
Language: R
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
spocc
= SPecies OCCurrence data
At rOpenSci, we have been writing R packages to interact with many sources of species occurrence data, including GBIF, Vertnet, BISON, iNaturalist, the Berkeley ecoengine, AntWeb, and eBird. Other databases are out there as well, which we can pull in. spocc
is an R package to query and collect species occurrence data from many sources. The goal is to to create a seamless search experience across data sources, as well as creating unified outputs across data sources.
spocc
currently interfaces with ten major biodiversity repositories
Global Biodiversity Information Facility (GBIF) (via rgbif
)
GBIF is a government funded open data repository with several partner organizations with the express goal of providing access to data on Earth's biodiversity. The data are made available by a network of member nodes, coordinating information from various participant organizations and government agencies.
Berkeley Ecoengine (via ecoengine
)
The ecoengine is an open API built by the Berkeley Initiative for Global Change Biology. The repository provides access to over 3 million specimens from various Berkeley natural history museums. These data span more than a century and provide access to georeferenced specimens, species checklists, photographs, vegetation surveys and resurveys and a variety of measurements from environmental sensors located at reserves across University of California's natural reserve system.
iNaturalist iNaturalist provides access to crowd sourced citizen science data on species observations.
VertNet (via rvertnet
)
Similar to rgbif
, ecoengine, and rbison
(see below), VertNet provides access to more than 80 million vertebrate records spanning a large number of institutions and museums primarly covering four major disciplines (mammology, herpetology, ornithology, and icthyology). Note that we don't currenlty support VertNet data in this package, but we should soon
Biodiversity Information Serving Our Nation (via rbison
)
Built by the US Geological Survey's core science analytic team, BISON is a portal that provides access to species occurrence data from several participating institutions.
eBird (via rebird
)
ebird is a database developed and maintained by the Cornell Lab of Ornithology and the National Audubon Society. It provides real-time access to checklist data, data on bird abundance and distribution, and communtiy reports from birders.
AntWeb (via AntWeb
)
AntWeb is the world's largest online database of images, specimen records, and natural history information on ants. It is community driven and open to contribution from anyone with specimen records, natural history comments, or images.
iDigBio (via ridigbio
)
iDigBio facilitates the digitization of biological and paleobiological specimens and their associated data, and houses specimen data, as well as providing their specimen data via RESTful web services.
OBIS OBIS (Ocean Biogeographic Information System) allows users to search marine species datasets from all of the world's oceans.
Atlas of Living Australia ALA (Atlas of Living Australia) contains information on all the known species in Australia aggregated from a wide range of data providers: museums, herbaria, community groups, government departments, individuals and universities; it contains more than 50 million occurrence records.
The inspiration for this comes from users requesting a more seamless experience across data sources, and from our work on a similar package for taxonomy data (taxize).
BEWARE: In cases where you request data from multiple providers, especially when including GBIF, there could be duplicate records since many providers' data eventually ends up with GBIF. See ?spocc_duplicates
, after installation, for more.
See CONTRIBUTING.md
Stable version from CRAN
all.packages("spocc", dependencies = TRUE)
Or the development version from GitHub
all.packages("devtools")
ools::install_github("ropensci/spocc")
ary("spocc")
Get data from GBIF
<- occ(query = 'Accipiter striatus', from = 'gbif', limit = 100))
earched: gbif
ccurrences - Found: 617,957, Returned: 100
earch type: Scientific
gbif: Accipiter striatus (100)
Just gbif data
gbif
pecies [Accipiter striatus (100)]
irst 10 rows of [Accipiter_striatus]
A tibble: 100 × 63
name longitude latitude prov issues key
<chr> <dbl> <dbl> <chr> <chr> <int>
Accipiter striatus -97.12924 32.70085 gbif cdround,gass84 1453324136
Accipiter striatus -84.74625 40.01773 gbif cdround,gass84 1453369124
Accipiter striatus -72.58904 43.85320 gbif cdround,gass84 1453335509
Accipiter striatus -96.77096 33.22315 gbif cdround,gass84 1453335637
Get fine-grained detail over each data source by passing on parameters to the packge rebird in this example.
<- occ(query = 'Setophaga caerulescens', from = 'ebird', ebirdopts = list(region = 'US')))
earched: ebird
ccurrences - Found: 0, Returned: 199
earch type: Scientific
ebird: Setophaga caerulescens (199)
Just ebird data
ebird
pecies [Setophaga caerulescens (199)]
irst 10 rows of [Setophaga_caerulescens]
A tibble: 199 × 12
name longitude latitude prov
<chr> <dbl> <dbl> <chr>
Setophaga caerulescens -81.74960 24.57340 ebird
Setophaga caerulescens -82.50378 27.31897 ebird
Setophaga caerulescens -82.81150 27.83556 ebird
Setophaga caerulescens -93.94818 29.69841 ebird
Get data from many sources in a single call
dopts = list(region = 'US'); gbifopts = list(country = 'US')
<- occ(query = 'Setophaga caerulescens', from = c('gbif','bison','inat','ebird'), gbifopts = gbifopts, ebirdopts = ebirdopts, limit = 50)
<- occ2df(out)
(dat); tail(dat)
A tibble: 6 × 6
name longitude latitude prov date key
<chr> <chr> <chr> <chr> <date> <chr>
Setophaga caerulescens -122.673863 45.476817 gbif 2017-01-09 1453379582
Setophaga caerulescens -83.035698 35.431075 gbif 2016-04-25 1453190650
Setophaga caerulescens -83.162943 41.615537 gbif 2016-05-12 1269558094
Setophaga caerulescens -74.405661 40.058324 gbif 2016-05-20 1453340127
Setophaga caerulescens -83.449402 44.252577 gbif 2016-05-14 1291104360
Setophaga caerulescens -83.449517 44.253819 gbif 2016-05-07 1291149600
A tibble: 6 × 6
name longitude latitude prov date key
<chr> <chr> <chr> <chr> <date> <chr>
Setophaga caerulescens -82.8282344 27.8851167 ebird 2017-04-18 L3547190
Setophaga caerulescens -82.64435 27.532639 ebird 2017-04-18 L189003
Setophaga caerulescens -81.7713915 26.1084774 ebird 2017-04-18 L2603780
Setophaga caerulescens -84.8486335 29.671734 ebird 2017-04-18 L352112
Setophaga caerulescens -80.7833333 33.7833333 ebird 2017-04-18 L109521
Setophaga caerulescens -81.9212021 26.746724 ebird 2017-04-17 L3579621
All data cleaning functionality is in a new package scrubr. On CRAN.
All mapping functionality is now in a separate package mapr (formerly known as spoccutils
), to make spocc
easier to maintain. On CRAN.
spocc
in R doing citation(package = 'spocc')