dvn v0.3.5

0

Monthly downloads

0th

Percentile

Access to Dataverse 3 APIs

Provides access to Dataverse version 3 APIs, enabling access to archived data (and metadata), and the ability to create and manipulate studies in a user's dataverse(s). For Dataverse server versions >= 4.0, please use the dataverse package <https://github.com/IQSS/dataverse-client-r> instead.

Readme

R Access to the Dataverse Network

Many dataverse servers now use Dataverse version 4.0 or greater. A separate package, dataverse, is being developed to work with these newer installations.

The dvn package for R integrates public data sharing into the reproducible research workflow. As such, dvn provides access to both the Data Sharing API and the Data Deposit API for the Dataverse Network online data repository system. The Data Sharing API enables searches of any public dataverse, returning study and file metadata. Limited support is also provided for data download, when terms of use allow direct download of public data.

The Data Deposit API allows users to directly create and modify dataverse listings (studies, metadata, and files), thereby integrating data archiving directly into the R workflow with just a few simple functions. The Data Deposit API is built on the SWORD protocol, though not all features are fully supported by the API.

dvn defaults to providing access to the Harvard Dataverse Network, but this can be changed in each function call or globally using options(dvn = 'https://thedata.harvard.edu/dvn/') for any valid Dataverse Network.

Users interested in downloading metadata from archives other than Dataverse may be interested in Kurt Hornik's OAIHarvester, which offers metadata download from any web repository that is compliant with the Open Archives Initiative standards. Additionally, rdryad uses OAIHarvester to interface with Dryad. The rfigshare package works in a similar spirit to dvn with http://figshare.com/.

Functions for the Data Sharing API

Metadata Search Functions

  • dvSearch, to search public dataverses
    • dvSearchFields, to provide the searchable fields for use in dvSearch
  • dvMetadata, to retrieve the metadata for a study
    • dvMetadataFormats, to retrieve available metadata formats for a study
    • dvExtractFileIds, to extract available files from the dvMetadata response
    • Using dvTermsOfUse(dvMetadata(objectId)) displays Terms Of Use as HTML for the study

File Access Functions

  • dvDownloadInfo, to retrieve information about a study file
  • dvDownload, to download a study file (if allowed)

Functions for the Data Deposit API

The core workflow for the Data Deposit API involves creating a study listing using dvCreateStudy, adding one or more files with dvAddFile, and then making the study public with dvReleaseStudy. Use of all Data Deposit API functions requires a valid username and password for the selected Dataverse Network, which can be set in each function call or globally using options(dvn.user = 'username', dvn.pwd = 'password').

  • dvCreateStudy, to create a study listing using metadata (i.e., cataloging information)
    • Use dvBuildMetadata to create metadata for use in dvCreateStudy or dvEditStudy
    • Use dvEditStudy to overwrite a study's metadata
  • dvAddFile, to add file(s) or active R dataframes to a study
  • dvReleaseStudy, to publicly release a study

Here is simple code to enact that workflow:

options(dvn.user = 'username', dvn.pwd = 'password')
doc <- dvServiceDoc()
meta <- dvBuildMetadata(title="My Study", creator="Doe, John")
study <- dvCreateStudy(doc, meta)
dvAddFile(study, filename)
dvReleaseStudy(study)

The following functions allow users to view and modify existing studies:

  • dvDeleteFile, to delete a file from a study
  • dvDeleteStudy, to deaccession a released study, or delete an unreleased study
  • dvUserStudies, to list studies in a named dataverse
  • dvStudyStatement, to access a summary of a study (including citation and stable URI)
  • dvServiceDoc, to identify the dataverse(s) accessible to a user (This is not particularly relevant to users with access to only one dataverse)
  • dvStudyAtom, to view study-level URIs for using the Data Deposit API (This is not important for most users, unless they plan to call dvDepositQuery directly)

Installation

CRAN Version Downloads Build Status

You can find a stable release on CRAN, or install the latest development version from GitHub using Hadley's devtools package:

if (!require("devtools")) {
    install.packages("devtools")
    library("devtools")
}
install_github("ropensci/dvn")
library("dvn")

Functions in dvn

Name Description
dvDepositQuery Execute a Data Deposit API Query
dvDownload Download a file
dvEditStudy Edit a study
dvBuildMetadata Build the Atom object to create or edit a study.
dvAddFile Add a study file
dvExtractFileIds Extract fileId(s) from metadata
dvDownloadInfo Retrieve file download information
dvDeleteFile Delete a study file
dvCreateStudy Create a study in a named Dataverse
dvDeleteStudy Delete (or deaccession) a study
dvServiceDoc Get Dataverse Service Document
dvn-package Access to Dataverse 3 APIs
dvSearchFields Lookup available search fields
dvReleaseStudy Publicly release a study
dvStudyAtom Obtain a study's Atom document
dvMetadata Retrieve metadata
dvUserStudies Studies in a Dataverse
dvTermsOfUse Terms of Use
dvQuery Execute a Data Sharing API Query
dvMetadataFormats Retrieve available metadata formats
dvStudyStatement Obtain a study statement
dvSearch Search a Dataverse
No Results!

Last month downloads

Details

Date 2016-06-07
License GPL-2
URL https://github.com/ropensci/dvn
BugReports https://github.com/ropensci/dvn/issues
NeedsCompilation no
Packaged 2016-06-07 14:49:40 UTC; THOMAS
Repository CRAN
Date/Publication 2016-06-07 17:09:00
imports RCurl , utils , XML
Contributors Thomas Leeper

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/dvn)](http://www.rdocumentation.org/packages/dvn)