spocc icon indicating copy to clipboard operation
spocc copied to clipboard

provider/dataset citation helpers

Open sckott opened this issue 4 years ago • 1 comments

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 avatar Dec 12 '19 20:12 sckott

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.

  • [ ] remake bison_citation() in line with gbif_citation so that it can take outputs of data get fxns, and spit out citations
  • [ ] when above is done, use here in spocc

sckott avatar Feb 02 '20 16:02 sckott