ropensci / spocc

Species occurrence data toolkit for R
https://docs.ropensci.org/spocc
Other
115 stars 27 forks source link

provider/dataset citation helpers #224

Open sckott opened 4 years ago

sckott commented 4 years ago

as we have rgbif::gbif_citation in rgbif, we should have some methods/infrastructure to help users very easily get citations for data providers and datasets within providers.

probably most queries will return citation info of some kind, probably just a matter of exposing that to users easily

for gbif, we could leverage gbif_citation here probably

one issue with gbif is that we don't support downloads here, so there's no DOIs for gbif outputs here

sckott commented 4 years ago

BISON

They ask for the following citation format:

[Data Provider or owner name]. [Resource or Dataset Name] published by [Data Provider name, address or affiliation(s)] (Accessed through Biodiversity Information Serving Our Nation (BISON), https://bison.usgs.gov, YYYY-MM-DD)

For example: Gordon, J. U.S. Bird Occurrences published by Field Museum of Natural History, Museum of Vertebrate Zoology, University of Washington Burke Museum, and University of Turku (Accessed through Biodiversity Information Serving Our Nation (BISON), https://bison.usgs.gov, 2007-02-22)

Getting providerID and resourceID

out <- occ(query = 'Setophaga caerulescens', from = 'bison',  limit=5)
# providerID's
out$bison$data$Setophaga_caerulescens$providerID
# resourceID's
out$bison$data$Setophaga_caerulescens$resourceID

rbison has a fxn bison_citation, but it just prints out the above info on how to make a citation.