R
Permalink
Failed to load latest commit information.
R added oai fxn tests, made id param in getrecord mandatory Feb 11, 2016
inst/ignore switched to using oai instead of older oai-pmh pkg fix #9 Aug 18, 2015
man-roxygen updated readme, change references in docs to solrium not solr Oct 26, 2015
man added oai fxn tests, made id param in getrecord mandatory Feb 11, 2016
tests
.Rbuildignore dont ignore tests Aug 22, 2016
.gitignore ignore .rhistory file Mar 6, 2015
.travis.yml remove covr for travis for now while datacite servers down Aug 20, 2016
CONDUCT.md added code of conduct Oct 26, 2015
DESCRIPTION fixed tests for new oai version Nov 23, 2016
LICENSE
NAMESPACE use oai::id instead of old fxn name, update man pages Feb 6, 2016
NEWS.md
README.Rmd cran version badge to readme, bump to dev version Feb 12, 2016
README.md
cran-comments.md
rdatacite.Rproj switched to using oai instead of older oai-pmh pkg fix #9 Aug 18, 2015

README.md

rdatacite

Build Status codecov.io rstudio mirror downloads cran version

rdatacite provides programmatic accesses to DataCite metadata

Installation

Stable CRAN version

install.packages("rdatacite")

Development version from github

devtools::install_github("ropensci/rdatacite")
library('rdatacite')

OAI-PMH

Ping the service

dc_oai_identify()
#>   repositoryName                     baseURL protocolVersion
#> 1   DataCite MDS http://oai.datacite.org/oai             2.0
#>           adminEmail    earliestDatestamp deletedRecord
#> 1 admin@datacite.org 2011-01-01T00:00:00Z    persistent
#>            granularity compression compression.1
#> 1 YYYY-MM-DDThh:mm:ssZ        gzip       deflate
#>                                      description
#> 1 oaioai.datacite.org:oai:oai.datacite.org:12425

List metadata formats

dc_oai_listmetadataformats(id = "56225")
#> $`oai:oai.datacite.org:56225`
#>   metadataPrefix
#> 1         oai_dc
#> 2       datacite
#> 3   oai_datacite
#>                                                        schema
#> 1              http://www.openarchives.org/OAI/2.0/oai_dc.xsd
#> 2 http://schema.datacite.org/meta/nonexistant/nonexistant.xsd
#> 3              http://schema.datacite.org/oai/oai-1.0/oai.xsd
#>                             metadataNamespace
#> 1 http://www.openarchives.org/OAI/2.0/oai_dc/
#> 2      http://datacite.org/schema/nonexistant
#> 3     http://schema.datacite.org/oai/oai-1.0/

List identifiers

dc_oai_listidentifiers(from = '2011-06-01T', until = '2011-07-01T')
#> <ListRecords> 5 X 4
#>
#>                   identifier            datestamp setSpec setSpec.1
#> 1 oai:oai.datacite.org:32153 2011-06-08T08:57:11Z     TIB  TIB.WDCC
#> 2 oai:oai.datacite.org:32200 2011-06-20T08:12:41Z     TIB TIB.DAGST
#> 3 oai:oai.datacite.org:32220 2011-06-28T14:11:08Z     TIB TIB.DAGST
#> 4 oai:oai.datacite.org:32241 2011-06-30T13:24:45Z     TIB TIB.DAGST
#> 5 oai:oai.datacite.org:32255 2011-07-01T12:09:24Z     TIB TIB.DAGST

Get records

dc_oai_getrecord(id = "56225")
#> <GetRecord> 1 X 23
#>
#>                   identifier            datestamp setSpec setSpec.1
#> 1 oai:oai.datacite.org:56225 2014-06-03T12:03:28Z      BL    BL.ADS
#> Variables not shown: title (chr), creator (chr), publisher (chr), date
#>      (chr), identifier.3 (chr), identifier.1 (chr), identifier.2 (chr),
#>      relation (chr), subject (chr), subject.1 (chr), language (chr), type
#>      (chr), type.1 (chr), format (chr), format.1 (chr), rights (chr),
#>      rights.1 (chr), coverage (chr), coverage.1 (chr)

You can pass in more than one identifier to id parameter.

Search API

This is the API for the same query interface you'd use on the DataCite website.

Search

Search for the term laser

dc_search(q = "laser", fl = c('doi','publicationYear'), rows = 5)
#> Source: local data frame [5 x 2]
#>
#>                          doi publicationYear
#>                        (chr)           (chr)
#> 1 10.17035/D.2016.0008119129            2016
#> 2        10.5169/SEALS-52668            1982
#> 3      10.2314/GBV:676509665            2011
#> 4      10.2314/GBV:667365621            2010
#> 5      10.2314/GBV:574957529            2007

Another search: published between 2000 and 2005

dc_search(q = "publicationYear:[2000 TO 2005]", fl = c('doi', 'publicationYear'), rows = 5)
#> Source: local data frame [5 x 2]
#>
#>                   doi publicationYear
#>                 (chr)           (chr)
#> 1      10.13155/36809            2004
#> 2      10.13155/36807            2003
#> 3 10.7892/BORIS.75282            2004
#> 4 10.7892/BORIS.75280            2002
#> 5     10.15150/ATW122            2002

Facet

dc_facet(q = "wind", facet.field = 'publisher_facet', facet.limit = 5)
#> $facet_queries
#> NULL
#>
#> $facet_fields
#> $facet_fields$publisher_facet
#>                                                                   X1    X2
#> 1         PANGAEA - Data Publisher for Earth & Environmental Science 30670
#> 2 Data-Planet™ Statistical Ready Reference by Conquest Systems, Inc.  1119
#> 3                                                        Unpublished   760
#> 4                                                           Figshare   317
#> 5                                           Archaeology Data Service   263
#>
#>
#> $facet_pivot
#> NULL
#>
#> $facet_dates
#> NULL
#>
#> $facet_ranges
#> NULL

Stats

dc_stats(q = "ecology", stats.field = 'date')
#> $data
#>                          min                max count missing
#> date 01-Jan-2007/29-Nov-2010 September 30, 2015 13584    3989
#>
#> $facet
#> NULL

More-like-this

dc_mlt(q = "ecology", mlt.fl = 'title', mlt.count = 2, fl = 'doi')
#> $docs
#> Source: local data frame [10 x 1]
#>
#>                    doi
#>                  (chr)
#> 1    10.5167/UZH-76892
#> 2      10.5167/UZH-584
#> 3    10.5167/UZH-61344
#> 4      10.5167/UZH-714
#> 5    10.5167/UZH-41217
#> 6      10.5167/UZH-402
#> 7    10.5167/UZH-49216
#> 8      10.5167/UZH-503
#> 9    10.5167/UZH-38402
#> 10 10.7892/BORIS.16333
#>
#> $mlt
#> $mlt$`1712990`
#>                         doi
#> 1 10.13140/RG.2.1.3868.5287
#> 2 10.6084/M9.FIGSHARE.15727
#>
#> $mlt$`1710865`
#>                        doi
#> 1 10.7890/ETHZ-A-000467066
#> 2 10.7890/ETHZ-A-000467004
#>
#> $mlt$`1699696`
#>                         doi
#> 1 10.13140/RG.2.1.3868.5287
#> 2 10.6084/M9.FIGSHARE.15727
#>
#> $mlt$`1695042`
#>                    doi
#> 1 10.5169/SEALS-511492
#> 2 10.5169/SEALS-421764

Meta

  • Please report any issues or bugs.
  • License: MIT
  • Get citation information for rdatacite in R doing citation(package = 'rdatacite')
  • Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

ropensci